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CHAPTER 1 
INTRODUCTION 


1.1 MANUAL SCOPE 

This manual provides a comprehensive description of the functional 
and operational characteristics of the VAX-11/78@8@ diagnostic 
system. The level of detail presented provides a resource for 
appropriate branch courses of the field service training program 
and for a field reference. Table 1-1 provides a list of related 
documents. Note that a glossary of diagnostic software terms is 
provided in Appendix A. 


Table 1-1 VAX-11/788 System Manuals 


Document Title Control Number Form 


VAX-11/78@ Power System 
Technical Description EK-PS780-TD-@61 In Microfiche Library 


VAX-11/788 System 
Installation Manual EK-SI78@-IN-901 Available in hard copy* 


DS78@ Diagnostic System 
User's Guide EK-DS788-UG-99@1 Available in hard copy* 


DS78@ Diagnostic System 
Technical Description EK-DS786-TD-@61 In Microfiche Library 


FP78@ Floating-point 
Processor Technical 
Description EK-FP78@-TD-901 In Microfiche Library 


REP@5/REP@6 Subsystem 
Technical Description EK-REP@6-TD-901 In Microfiche Library 


VAX-11 KA78@ Central 
Processor Technical 
Description EK-MS780-TD-901 In Microfiche Library 


VAX-11 MS78@ Memory 
System Technical 
Description EK-MS78@8-TD-@@1 In Microfiche Library 


DW78@ Unibus Adapter 
Technical Description EK-DW780-TD-@61 In Microfiche Library 


KC78@ Console Interface 
Technical Description EK-KC780-TD-901 In Microfiche Library 


VAX-11/78@ Architecture 
Handbook EB@7466 Available in hard copy* 


Table 1-1 VAX-11/788 System Manuals (Cont) 


Document Title Control Number Form 


VAX-11/78@ Software 
Handbook EBO8126 Available in hard copy* 


VAX-11/786 Hardware 
Handbook EB89987 Available in hard copy* 


VAX/VMS Primer AA-D@30A-TE Available in hard copy* 


VAX/VMS Command Language 
User's Guide AA-D@23A-TE Available in hard copy* 


VAX-11 MACRO User's 
Guide AA-D@33A-TE Available in hard copy* 


VAX-11 Linker Reference 
Manual AA-D@19A-TE Available in hard copy* 


VAX-11 Symbolic Debugger 
Reference Manual AA-D@26A-TE Available in hard copy* 


*These documents can be ordered from: 


Digital Equipment Corporation 

444 Whitney Street 

Northboro, MA @1532 

Attn: Printing and Circulation Services (NR2/M15) 
Customer Services Section 


For information concerning microfiche libraries, contact: 


Digital Equipment Corporation 
Micropublishing Group, PK3-2/T12 
129 Parker Street 

Maynard, MA @1754 


Le DIAGNOSTIC SYSTEM CAPABILITIES 

The VAX-11/78@ diagnostic system is a set of software components 
integrated as a system to provide a wide range of error detection 
and isolation capabilities for the VAX-11/78@ hardware. The 
diagnostic levels range from system functional tests to dedicated 
microprogram techniques capable of identifying a faulty module 
(printed circuit board) or group of modules. In addition, the 
diagnostic control functions provide substantial selection and 
execution options. 


The overall diagnostic strategy satisfies the major field service 
goals of: 


a. High quality and efficiency of system installation, by 
providing formal installation procedures, automated test 
package configurations, and a system exerciser program 
that can be configured for specific VAX-11/7898 systems. 


b. Reduction of fault isolation and repair times, by 
providing high visibility diagnostic programs (programs 
accessible to the operator) and procedures keyed to the 
field service troubleshooting and repair philosophy. 


The diagnostic system is supported by a PDP-11/V@3 (LSI-11) 
microcomputer console system. In addition to providing for local 
(on-Site) diagnostic execution, the diagnostic system allows for 
diagnosis from a remote diagnostic center. 


1.3 DIAGNOSTIC SYSTEM OVERVIEW 

The diagnostic system consists of programs that are organized 
hierarchically (from general to specific capabilities) in six 
levels. Each level contains one or more categories, as follows: 


Level l -- Operating system (VMS) based diagnostic programs 
(using queue I/O) 


System exerciser program 

Level 2 -- Diagnostic supervisor--based diagnostic programs that 
can be run either under VMS or in the standalone mode 
(using queue I/O) 

Bus interaction program 

Formatter and reliability level peripheral diagnostic 
programs 


Level 2R -- Diagnostic supervisor--based diagnostic programs that 
can be run only under VMS. 


Certain peripheral diagnostic programs 


Level 3 -- Diagnostic supervisor--based diagnostic programs that 
can be run in standalone mode only (using direct I/0) 


Functional level peripheral diagnostic programs 
Repair level peripheral diagnostic programs 
Cluster diagnostic programs 


Level 4 -- Standalone macrodiagnostic programs that run without 
the supervisor. 


Hardcore instruction test 


1-3 


Console 
Level-- Console-based diagnostics that can be run in the 
standalone mode only 


Microdiagnostics 

Console program 

Octal Debugging Technique (ODT) 
ROM resident power-up tests 
LSI-1l1l diagnostics 


The diagnostic programs can be used for preventive maintenance 
checks to ensure proper computer operation; or, if system 
malfunctions have been detected, specific programs or groups of 
programs can be run to isolate the fault. 


Figure 1-1 shows the relation of the six levels to four diagnostic 
program operating environments. The console environment requires 
exclusive use of the VAX-11/788 system (Standalone mode). It 
includes only the console level programs. In this environment, 
program control is exercised by the LSI-11 processor in the 
console subsystem. 


In the cluster environment, the system environment, and the user 
environment, control is exercised in the VAX-11/780 CPU. The 
cluster environment supports only standalone diagnostic programs. 
It includes level 4 programs and some level 3 programs. The level 
3 programs Supported are those that test the CPU and the channel 
adapters. 


The system environment supports peripheral diagnostic programs 
that can run in the standalone mode. These include level 2 
programs and level 3 peripheral programs. 


The user environment Supports only programs that can be run under 
VMS, namely levels 2R, 2, and l. 


In general, the diagnostic system uses a building block approach 
to testing (and subsequent fault detection and isolation). When 
the diagnostic programs are executed in the standard system 
checkout sequence, they will initially test a minimum (basic) set 
of logical functions to enSure their proper operation. After these 
basic operations are verified, a larger and more complex block is 
tested, using the previously tested block as a base. This sequence 
is implemented consistently from the ROM resident power-up tests 
(which check the console) to interactive system tests executed as 


user mode tasks under the VMS operating system, aS Shown in Figure 
1-2. 


It may be that a diagnostic program will indicate an error in a 
hardware component which is more easily diagnosed by another 
program. For instance, the bus interaction program may indicate a 
failure of a tape drive. The tape reliability program may also 
detect the same failure or a related failure, but the problem may 
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be on the tape drive controller, the RH78@ (MBA), or the KA78@ 
(CPU). Proper use of the six levels of diagnostic programs should 
enable the field service engineer to identify the failure quickly 
and accurately. 


1.4 DIAGNOSTIC SYSTEM EXECUTION ENVIRONMENTS 

Most of the diagnostic programs must be run off-line (standalone). 
In other words, they require exclusive use of the VAX-11/78@ 
computer system and will not run under the VMS operating system. 
Diagnostic programs in levels 3, 4, and the console level are of 
this type (Figure 1-2). The diagnostic programs in level 2 can be 
run off-line or on-line (under VMS). 


: Off-line diagnostics must be run from the console 
terminal. 


On-line diagnostics may be run from any terminal on the 
system and will share the computer system with other user 
mode programs. Figure 1-3 shows the execution 
environments required by the various diagnostic programs. 


1.5 CONSOLE DIAGNOSTICS 

On power up, a set of ROM reSident tests verifies the proper 
functioning of the LSI-11 within the console subsystem before the 
console program is booted from the floppy disk. If the console 
program cannot be booted, the ROM resident tests, together with 
ODT, can be used to isolate the fault. For details see the 
VAX-11/78@ Diagnostic System User's Guide (EK-DS780-UG-881), 
Appendix D. In addition, a set of dedicated LSI-11 diagnostics may 
be used to perform in-depth tests on each component of the console 
subsystem. 


The console subsystem, in connection with the console program, 
provides the basis for the diagnostic system with the following 
functions: 

: Traditional lights and switch functions Such as EXAMINE, 
DEPOSIT, HALT, START, and single instruction 


Diagnostic and maintenance functions, including the 
capability to load diagnostic microcode into Writable 
Control Store (WCS), control execution, control single 
step clock functions, and examine key system points via a 
Serial diagnostic visibility bus (V Bus), and to deposit 
and examine data in locations in the VAX-11/78@8 main 
memory and I/O space 


Operator communication with the VAX-11/78@ software. 
The console program enables the operator to run microdiagnostics, 
to load and run the diagnostic supervisor (in the standalone mode) 


and the standalone macrodiagnostic programs (using VAX-11/78@ 
native code), and to boot the operating system. 
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Note that when the console program is running in the LSI-1l, it 
will always be in one of two modes, console I/O mode or program 
I/O mode. With the exception of the Control P (“P) command, the 
console commands (console command language) listed in the help 
files are available only when the console program is in the 
console I/O mode. 


In the console I/0 mode, the console program interprets’ the 
characters typed on the console terminal as console commands. In 
the program I/O mode, however, the console program is transparent 
to the operator. The console program passes characters from the 
console terminal directly to the VAX-11/78@ CPU for use by VMS or 
the diagnostic superviSor. 


Type Control P to switch from program I/O mode to console I/0 
mode. 


Type SET TERMINAL PROGRAM to switch from console I/O mode to 
program I/O mode. 


1.6 MICRODIAGNOSTIC PROGRAM 

The microdiagnostic program provides module isolation for logic 
failures within the CPU, floating-point accelerator and MOS memory 
controllers. The program will detect stuck high/low logic 
functions and open or grounded etch and wire interconnections. The 
microdiagnostics are organized in a bootstrapping test sequence 
(i.e., building blocks) of the console interface, CPU hardware, 
cache-transSlation buffer, I-stream buffer, Synchronous Backplane 
Interconnect (SBI), and memory controller and array. All detected 
faults result in an error typeout indicating the smallest set of 
modules to which the diagnostic can isolate the failure. 


The microdiagnostic program is initiated by one console command 
and executed from the CPU cluster test facility. The test facility 
consists of the console subsystem, console interface, Writable 
Control Store (WCS), and the V Bus. 


The microdiagnostic package consists of two major test divisions: 
console adapter and hardcore, and microtests. Each test division 
is controlled by an associated monitor that provides nondiagnostic 
services to that division. Both test division monitors are 
serviced by the console-resident microdiagnostic monitor. In 
addition to loading the test monitors, the microdiagnostic monitor 
retrieves microtest overlays from the floppy disk, loads test 
sequences into WCS, performs test dispatching and sequencing, 
performs error reporting, and manages fault isolation. The 
microdiagnostic monitor also allows the operator microdiagnostic 
test selection and execution options (Chapter 4). Figure 1-4 shows 
overall monitor relationships and test Sequencing. 
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Figure 1-4 Monitor Relationships and Test Sequencing 


1.6.1 Console Adapter and Hardcore Division 

The adapter and hardcore division microdiagnostic is composed of a 
test stream of pSeudo-instructions and test data located on the 
console floppy disk. Note that the pseudo-instructions are defined 
Specifically for the test stream. This diviSion tests the console 
adapter (CIB module), microsequencer, WCS, and a subset of the 
data paths. The hardcore monitor is called into the console memory 
by the microdiagnostic monitor. The hardcore monitor, in turn, 
retrieves small blocks (+1.5K bytes) of test data from the floppy 
into a console buffer, and then controls execution. When the 
current block has been completed, the hardcore monitor overlays 
this block with a new test block. The test data portion of the 
test stream iS comprised of data words and lists of VAX-11/78@ 
microinstructions. The microinstructions are loaded into the WCS 
and executed in single bus cycle or single time-State modes. 


When an error is detected, an error header message is typed. Then, 
if the HALTD flag iS not set, a trace message is typed and 
additional code is executed to isolate the fault. This additional 
testing will normally consist of V BuS compare instructions. 
Figure 1-5 shows monitor residency and the basic flow of the 
console adapter and hardcore tests. 


1.6.2 Microtest Division 

The microtest division completes testing of the CPU not covered by 
the hardcore division, and provides isolation to a failing module. 
The microtests, which are executed under control of the microtest 
monitor, are divided into two subdivisions: GO chain and FAIL 
chain. The GO chain consists of microtests loaded into WCS and 
executed at full speed. The purpose of the GO chain is to detect 
an error. If an error is detected, control is passed to the FAIL 
chain, which isolates the error and reports the failing module 
through the microdiagnostic monitor. Note that the FAIL chain is 
executed only on detection of an error. 


The GO chain consists of a series of WCS overlays. Each overlay is 
approximately 1K microwords in length and will contain one or more 
microtests. Initially, the microdiagnostic monitor loads the first 
overlay into WCS; that overlay is then executed. If no error is 
detected, the next overlay is loaded into WCS and executed. This 
sequence continues until each test in each overlay has been 
executed, or until an error is detected. 


When the GO chain detectS an error, execution of the microtest 
that detected the error is suspended. The error microtest address 
is saved and used by the FAIL chain to restart microtest execution 
to recreate the conditions that detected the error. 


The FAIL chain reenters the failing microtest and begins fault 
isolation. The microtest is clocked a specific number of ticks 
from the error address and then certain V Bus’ Signals are 
processed. If the V Bus Signals identify the faulty module, an 
error report is made through the microdiagnostic monitor. If these 
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Signals do not identify the error, additional V Bus Signals are 
processed. In the case of an intermittent error which is not 
reproduced during FAIL chain execution, a report is printed that 
lists the modules involved in the failing GO chain microtest. 
Figure 1-6 shows monitor residency and the baSic test flow. 


1.7 MACRODIAGNOSTIC PROGRAMS 

The macrodiagnostic programs are written in VAX-11 MACRO and 
assembled in VAX-11 native code. Level 2, 2R, and 3 programs do 
not run independently; they must always be loaded and executed 
with the diagnostic supervisor. 


pray eee | Diagnostic Supervisor 

The diagnostic supervisor provides a framework that supports each 
of the macrodiagnostic programs, one at a time. It operates in 
three environments and provides two major functions. Two of these 
environments, cluster environment (CE) and system environment 
(SE), constitute the standalone mode. The diagnostic supervisor 
operates in the user environment (USE) when it runs under the VMS 
operating system. In each of these environments different modules 
within the diagnostic sSuperviSor are activated. The first major 
function of the diagnostic supervisor is the interpretation of the 
command line typed on the operator's terminal. The command line 
interpreter (CLI) portion of the supervisor performs this 
function, enabling the operator to control the loading, 
Sequencing, and execution of diagnostic test programs. The program 
interface (PGI) performs the second major function of the 
supervisor, providing a set of common services required by some or 
all diagnostic programs. The PGI services include operator 
interaction routines, error message formatting, memory management, 
and I/O request handling. Notice that the operator can communicate 
with the diagnostic program only through the CLI and the _ PGI 
message service in the Supervisor. 


The supervisor supports programs that provide their own device 
interfaces (direct I/0) and programs that require I/O services. 
The direct I/0 diagnostic programs must be run in the standalone 
mode (cluster environment and system environment), since VMS 
inhibits direct access to peripheral devices. Programs that do not 
directly access the peripheral devices under test rely on queue 
I/O system services. Both VMS and the diagnostic supervisor 
provide queue I/O system services, so that these programs can run 
in either the standalone mode (in the system environment) or the 
user mode (user environment, under VMS). When the diagnostic 
Programs requiring queue I/0 services are run in the user mode, 
the supervisor passes the queue I/O requests directly to VMS. When 
queue I/O diagnostic programs are run standalone, the supervisor 
emulates the VMS operating system, providing the queue I/O system 
Services. Figure 1-7 shows the functions of the diagnostic 
Supervisor in the three macrodiagnostic operating environments. 
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Functions of the Diagnostic Supervisor Environments 


1.7.2 Cluster Diagnostic Programs 

The CPU cluster exerciser, the RH78@ (MBA) diagnostic program, and 
the DW788 (UBA) diagnostic program test the VAX-11/78@ cluster 
hardware. They run under the cluster environment portion of the 
diagnostic supervisor, in the standalone mode. 


1.7.2.1 CPU Cluster Exerciser Package -- The cluster exerciser 
package consists of three diagnostic programs. The package 
provides a comprehensive functional test of the CPU cluster, 
including the CPU, the Unibus and Massbus adapters, and memory. 
The first program (ESKAX) is the quick verify portion of the CPU 
cluster exerciser package. The second program (ESKAY) tests the 
native mode instruction set of the VAX-11/78@. EXKAZ, the third 
program in the package, checkS memory management and the PDP-11l 
instruction set (in compatability mode). 


The CPU cluster exerciser programs identify failing functions and 
failing subsystems. For further fault isolation the operator 
should run the microdiagnostic program or restrict the desired CPU 
cluster exerciser program to the minimum number of modules which 
will detect the failure, through commands to the diagnostic 
Supervisor. 


1.7.2.2 RH789 (MBA) Diagnostic Program -- The RH78@ (MBA) 
diagnostic program tests the majority of the MBA logic regardless 
of the type of peripheral device attached to the Massbus. Although 
the program does not provide explicit component level fault 
isolation, every detectable error is associated with an 
operator-selectable scope loop. Diagnosis of attached devices is 
not attempted. Verification of the Massbus transceivers and cables 
is possible with a Massbus exerciser (MBE, RH11-TB) attached to 
the Massbus. Use of an MBE on the Massbus also allows verification 
of the MBA ability to perform high speed block transfers. Note 
that either a device or a bus terminator must be attached to the 
Massbus to enable program execution. The program tests the MBA at 
three levels. 


de The first level checks basic functions. The functions 
tested are those which are necessary for subsequent, 
detailed fault detection. The objective is to locate 
functional failures prior to testing for explicit bit 
failures. Map register access, virtual address register 
access, and correct data input buffer byte selection are 
tested at this level. 


23 The second level of testing locates bit failures (stuck 
high/low). The program toggles bits directly accessible 
to the CPU, and it sets and clears bits indirectly by 
setting up specific commands and conditions. 
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3% The third level determines the ability of the MBA to meet 
system demands. The program performs block transfers 
uSing the MBA wraparound features. These block transfers 
are executed in the maintenance mode and ensure that the 
MBA will support data transfers typically associated with 
system software. In addition, the program tests’ the 
ability of the MBA to interrupt the CPU under all legal 
conditions. 


1.7.2.3 DW788 (UBA) Diagnostic Program -- Like the RH78@ (MBA) 
diagnostic program, the DW78@ (UBA) diagnostic program tests most 
of the UBA logic. Every detectable error is associated with an 
operator-selectable scope loop. The program does not attempt to 
test devices attached to the Unibus. However, if a Unibus 
exerciser is attached to the Unibus, the program will verify the 
integrity of the Unibus transceivers and the ability of the UBA to 
respond to device-initiated functions. The program tests the UBA 
at seven levels. 


Lis The program tests the basic functions necessary for 
subsequent fault detection: the addressability of the UBA 
registers, their initial states, and whether they can be 
read and written. 


2 The program tests the RAM addressing capability of the 
UBA logic (accessing map registers, data path registers, 
and BRSVRs). 


3% Power-fail and interrupt functions of the UBA are tested 
next. 

4. The program creates and tests all error conditions. 

oe Extensive data transfer tests check the map registers, 


the direct data path, the buffered data paths, the data 
path registers, the Unibus address and data lines, and 
the microsequencer. 


6. The device tests check all types of data transfer on the 
Unibus: DATI, DATIP, DATO, DATOB initiated by the UBA and 
by the UBE. Interrupts from the UBE to the CPU are also 
tested at the four BR levels. 


Te The contention logic test checks for race conditions when 
the four microsequencer select lines (UBATT SEL, SB SEL, 
DMA SEL, FILE WRITE SEL) are asserted at about the same 
time. 
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1.8 PERIPHERAL DIAGNOSTIC PROGRAMS 

In accordance with the structure of the diagnostic system as a 
whole, the peripheral diagnostic programs are organized in a 
hierarchy. Repair and functional level programs are designed to 
test specific peripheral devices. These programs (with the 
exception of the line printer and terminal diagnostics) must be 
executed in the standalone mode under the system environment (SE) 
services of the supervisor, since they provide their own access 
(direct I/0) to the devices under test. The diagnostic programs 
which rely on VMS, or the supervisor, for access to the units 
under test (queue I/0) are each designed to test a range of 
peripheral device types. For example, the disk reliability program 
(ESRAA) will test all disk drive types supported by the VMS 
operating system. 


On error detection, the repair level diagnostic programs will call 
out both the failing device controller module and the failing 
function, dump the contents of relevant registers, and 1ist 
expected and received data patterns. The functional level programs 
provide register dumps and call out the failing function when an 
error is detected. The reliability and formatter level programs 
provide more detailed information on the failing function in 
addition to the register dumps. 


The system exerciser program tests the integrity of the major 
system buses (i.e., SBI, Massbus, Unibus) under heavy I/0 
activity, and it highlights any interaction problems that result. 
The program should be run as a dedicated process under VMS. No 
other program may run concurrently or compete for system 
resources, Since the program requires the use of all system 
resources. 


1.9 OPERATOR/VAX-11/788 COMMUNICATION 

The operator communicates with the VAX-11/788@ computer through the 
console subsystem. The console subsystem provides a programmed 
interface between the console terminal and the VAX-11/780 hardware 
and software, including the diagnostic system. The console 
Subsystem hardware consists of an LSI-11 microprocessor (11/83), a 
Single floppy disk drive and controller, a terminal and two serial 
line units, a VAX-11/78@ CPU console interface (CIB), and a 
control panel on the VAX-11/788 CPU cabinet. The console program 
includes a console command language and the software utilities 
that provide operator console functions. These functions are 
required for VMS and diagnostic Support. The paragraphs that 
follow introduce the baSic console functions. Refer to Chapter 2 
for a detailed description of the console command language. 


1.9.1 Console Terminal Modes 

The console terminal serves as the console program's I/O device 
and aS a VMS operator terminal. The console program has_ two 
operating modes: console I/O mode and program I/O mode. 


In console I/O mode, the terminal serves as the operator interface 
to the console panel functions, CPU debug functions, and CPU 
kernel test functions. In this mode console terminal input is not 
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passed to the VAX ISP-level software. All terminal input is 
interpreted by the LSI-11l1, and appropriate console functions are 
invoked. 


In program I/0 mode the terminal serves aS a VMS- operator 
terminal. All terminal input is passed, character by character, to 
the ISP-level software. All validity checking, etc. is performed 
by VMS. The console program is transparent to the VAX-11/78@ 
Software. All terminal output from the software is passed directly 
to the console terminal. 


1.9.2 Console Panel Equivalent Functions 

The functions in this group are those normally available through a 
traditional console panel. These functions include ISP-level 
program and CPU clock controls, and display and modification of 
memory elements. 


1.9.2.1 Program Control -- The console can initialize the CPU by 
setting certain logic to a defined state. It can initiate 
ISP-level instruction execution at a point specified by the 
program counter, aS well as terminate instruction execution. In 
addition, the console can bootstrap the system by loading memory 
with a specific file from the system load device, and initiate 
instruction execution at a predefined address after the load. The 
console can also stop ISP level instruction execution. 


1.9.2.2 Memory Element Display and Modification -- The console 
allows display and modification of memory elements in the 
VAX-11/788 including main memory, I/0, general, and _ internal 
register addressing space. The address spaces can be accessed, 
read, and written in the quantities specified below: 


a. Main memory elements: byte, word, longword, quadword 
quantities 


b. CPU general registers (R@#@--R13, SP, PC), and processor 
register space: longword quantity 


on CPU processor register space: longword quantity 


d. I/O registers: byte, word, longword quantities depending 
on register data length 


e. ID bus registers: longword quantity 


Eg VAX-11/788@ V Bus (Visibility Bus) channels can be 
displayed (V Bus channels are read-only) 


g. VAX-11/780 main memory and/or Writable Control Store 


(WCS) can be loaded from files on the console subsystem 
floppy disk. 
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1.9.2.3 Clock Control -- The CPU clock can be controlled by the 
console to provide single step clock mode for use in hardware or 
software debugging. The control modes available include single 
instruction step, single SBI bus cycle step, and single SBI time 
state step modes. 


Single instruction step mode allows ISP-level programs to execute 
one instruction at a time. This mode causes the CPU to enter the 
halt state after the instruction execution. 


Single SBI bus cycle step mode causes the CPU clock to stop each 
time SBI time state 8 (T@) is asserted. T#@ remains asserted until 
a control signal from the console causes the clock to resume 
operation. The clock ticks until the next SBI T@. 


Single SBI time state step mode causes the CPU clock to assert and 
hold a time state (T@, Tl, T2, or T3) until a control Signal from 
the console causes the next time state to be asserted and held. 


1.9.3 Console Control Functions 

The console control functions allow control of numeric radices, 
addressing modes, and data length, and provide for displaying 
console and CPU status. Functions are also provided that repeat 
commands and link multiple commands into a single executable 
command list. In addition, the console provides a means to control 
the number of fill characters to be added after special characters 
are sent to the console terminal. 


1.9.3.1 Default Settings -- The console allows specification of 
defaults for addressing modes, radix of numeric input and output, 
and the data length of addressable memory elements. Any default 
setting can be overridden within the context of a console command. 


a. The default addressing modes can be set for virtual, 
physical, ID Bus, V Bus, general register, or internal 
(processor) register. 


b. Default radices for console numeric input and output can 
be set to octal, decimal, or hexadecimal radix. 


Cs Defaults for memory element data lengths can be set for 
byte, word, longword, and quadword. 


d. Power-up defaults -- 
Address Type 


Radi x 
Data Length 


Physical 
Hexadecimal 
Longword (32 Bits) 
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1.9.3.2 Status Displays -- The console provides a means to 
display CPU and console subsystem status. The CPU status includes 
the stop/run state of the instruction set processor, the current 
clock step mode, and the state of the Stop on Microbreak Match 
Enable (SOMM). Console subsystem status includes the current 
setting of all console defaults and the number of terminal fill 
characters. 


1.9.3.3 Command Linking and Repeating -- The console provides a 
facility that allows multiple commands to be linked into a single 
executable list. Commands to be linked are entered into an 
internal console queue. The console operator can specify execution 
of the command queue one pass at a time. Or, the queue may be 
executed continuously. This facility allows the diagnostic user to 
create short routines of console commands for use in hardware 
debugging operations. 


The console also provides a facility to continuously execute a 
Single command or list of commands. Once initiated, command 
execution continues until terminated by the operator. The repeat 
facility allows maintenance personnel to scope the operation of 
CPU and subsystem logic invoked by console commands. 


1.9.3.4 Real-Time Delays -- The console provides a facility for 
introducing real-time delays of varying duration between the 
execution of console commands linked with the command linking 
facility. This function has no effect on the CPU, but only delays 
the console's processing of the next sequential command in the 
command queue. The delay facility is provided for use after 
console commands that invoke CPU functions which require time to 
complete (e.g., initialization). 
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BLANK 


CHAPTER 2 
CONSOLE PROGRAM AND CONTROL DESCRIPTION 


This chapter describes the console command language and associated 
command facilities. Where appropriate, examples of command usage 
are included. Also included are all applicable console error 
messages. 


2.1 CONSOLE PROGRAM OVERVIEW 

The following paragraphs provide a basic overview of the console 
software modules. Note that the services provided by the console 
are contained in the LSI-11 4K ROM and 8K RAM. The console 
provides services for console control, operator interface, 
microdiagnostic execution, VMS support functions and remote 
diagnosis. 


Ven reel | Command Getter 

The basic functions of this module are to retrieve a command line 
from the console terminal (get a command line routine), and 
provide a check point (or wait) loop for the console program 
(console null loop). 


The program spends the majority of its time in the null loop, 
which consists of a series of test points and conditional branches 
(e.g., bootstrap initiated, VAX-11/78@ CPU halted, etc.). Should 
any of these functions be active (i.e., flag set) the program 
performs a branch to the routine required to service the request 
initiated by that flag. 


2.1.2 Parser and Parser Tables 

The parser module decodes the command typed on the_ console 
terminal and provides a pointer to the appropriate routine to 
execute the command. The parser manipulates the command line to 
condition it for decoding (e.g., discarding leading blanks and 
checking for a delimiter in the command input string). The command 
is decoded through a set of syntax check trees that provide 
pointers to the appropriate execution routine within the command 
execution module. Any data required for command execution has been 
set up in tables included as part of the parser. 


2.1.3 Command Executor Module 

The command execution pointer from the parser is passed to the 
command execution module entry point. This entry point provides a 
pointer (i.e., starting address) to the appropriate command 
execution routine (e.g., DO BOOT, PERFORM QUAD CLEAR). The basic 
sequence of module action is: 


a. Apply switches or defaults for radix, address space, and 
data length. 

b. Execute command routine. 

C. Test for repeat function. 
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If a repeat function is specified, the routine monitors’ the 
console for the control character (“C) required to terminate the 
loop. 


The module also supplies the required subroutines to Support the 
execution functions (e.g., open a file, load a file). Following 
command execution, control is passed to the console null loop 
within the command getter module. 


2.1.4 Additional Services 
In addition to the command decoding and execution functions, the 
console provides several other services. 


Remote support is provided to allow console access from a remote 
terminal or computer. The facility also enables communication 
between local and remote operators, as well as transfer of console 
control between local and remote operators. 


VMS services are also provided. These services include routines 
for terminal support and the associated drivers, as well as a file 
service for the floppy drive and its associated drivers. The code 
for some of these services is contained in the ROM as well as the 
RAM. These services are provided through emulator traps. 


The console software also includes the basic LSI-11 processor and 
memory tests, that are executed on each power-up and bootstrap, 
and the primary bootstrap routine for the floppy. 


2eZ COMMAND TERMS AND SYMBOLS 
Table 2-1 provides a summary of terms and symbols used to describe 
the syntax of the console commands. 


Table 2-1 Term and Symbol Definitions 
Term/Symbol Definition 


< > Used to denote a category name (label) 
€.g., category name <address> represents 
a valid address 


! Used to indicate the Exclusive OR 
operation (i.e., Selection of parameters 
within a command line). For example, 
<A>!<B> means either <A> or <B> but not 
both is to be selected 


( ) Used to indicate that one of the 
Syntactic units of the expression is to 
be selected 


[ ] Used to indicate the part of an 
expression that is optional e.g., WAIT [ 
] indicates that the wait command takes 
an optional count argument 
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Table 2-1 


Term/Symbol 
<blank> 
<count> 


<XYZ -list> 


<address> 
<data> 
<qualifier> 


<input prompt> 


<reverse prompt> 


Term and Symbol Definitions (Cont) 


Definition 
Represents one or more spaces or tabs 
Represents a numeric count 


Indicates one or more occurrences’ from 
the category indicated by XYZ 


Represents an address argument 
Represents a numeric argument 
Represents a command modifier (Switch) 


Represents the console's input prompt 
String '>>>' 


Represents the linking prompt ‘'<<<'! 


<CR> Represents a console terminal carriage 
return 

<LF> Represents a console terminal line feed 

7 Delimits a command from its qualifiers 

+ Represents the default address when used 
aS an address argument in an examine or 
deposit command (The default address is 
the last address used plus the current 
data length in bytes.) 

= Used as an address argument in an examine 
or deposit command and represents’ the 
last address referenced. 

2.2.1 Notation Examples 


EXAMINE [ <qualifier - list> ] [<blank> <address> ] 


An examine command explanation follows. 


a. An examine command may optionally contain a list of one 
Or more qualifiers. 


b. An examine command may optionally contain an address 


argument. 


If the address is specified it must be preceded 


by one or more spaces or tabs. 
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Following is a list of valid examine commands: 


EXAMINE 

EXAMINE/BYTE/VIRTUAL 

EXAMINE <space> 123456 

EXAMINE <tab> 123456 

EXAMINE/WORD <Space> 123456 
EXAMINE/WORD <Space> <tab> 123456 


2.2.2 Command Abbreviations 
Console command words may be abbreviated by typing only enough 
characters to identify each command word. The minimum abbreviation 


for each command is specified in parentheses in each command 
description paragraph title. 


Example 

EXAMINE/VIRTUAL/BYTE 1234 

may be abbreviated to: 

E/V/B 1234 
233 CONSOLE COMMAND DESCRIPTIONS 
Each console command description is divided into three, four, or 
five descriptive segments, depending on the particular command. 
The descriptive segments are: 


a. Syntax: describes the command structure 


b. Command description: a brief paragraph describing command 
operation, general restrictions, or available options 


Cs Response: a description of the console program response 
to the specified command 


d. Qualifiers: a list of applicable command modifiers 

e. Options: a list of applicable command options. 
The descriptive segments use the terms and symbols defined in 
Table 2-1. Note that every command (or command line) must be 


terminated with a <CR>. 


Ae3e1 Boot Command (B) 
Syntax: BOOT [ <device name> ] <CR> 


The boot command initiates a VAX-11/78@ system bootstrap sequence. 
The command may support bootstrap operations from a set of 
alternate system devices. 


<device name> has the following format: DDn, where DD is a 


two-letter device mnemonic (e.g., DX for floppy), and n is a 
one-digit unit number. 
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If no <device name> is given with the boot command, the console 
will perform the boot sequence for the default system device by 
executing an indirect command file named DEFBOO.CMD. This indirect 
file contains the necessary console commands to boot from 
whichever device is chosen to be the default system device. 


If <device name> is given with the command, the console will 
execute an indirect command file named DDNBOO.CMD, where DDN is 
the <device name> given. 


Example 


BOOT RP@ -- will cause the console to execute an indirect 
command file named RP@BOO.CMD (console enters program I/0 
mode after executing the command file). 


Bootstraps from devices other than the system default device are 
performed by indirect command files containing the console 
commands necessary to boot an alternate device. After successful 
CPU bootstrap completion, a response from VMS will be displayed on 
the console terminal. 


2.3.2 Clear Command (CL) 
Syntax: Clear<BLANK>(SOMM ! Step) 


CLEAR SOMM The Stop on Microbreak Match (SOMM) enable on 
the console interface board is cleared -- 
(disabled). 


CLEAR STEP Any existing clock step mode (Single bus cycle, 
single time state, single instruction) is 
cleared, and the VAX-11/788 CPU clock will be in 
the normal (free-running) mode. 


Response: <CR><LF><CONSOLE-PROMPT> 


26355 Continue Command (C) 
Syntax: CONTINUE <CR> 


The continue command causes the VAX-11/78@ CPU to begin 
instruction execution at the address currently contained in the 
CPU program counter (PC). Note that CPU initialization is not 
performed. The console enters the program I/O mode after issuing 
the continue command. 


Response: <CR> <LF> (console enters program I/O mode) 
2.3.4 Deposit Command (D) 


Syntax: DEPOSIT [ <qualifier - list> ] <blank> <address> <blank> 
<data> <CR> 


Qualifiers: /BYTE, /WORD, /LONG, /QUAD, /NEXT, /VIRTUAL, 


/PHYSICAL, /V BUS, /INTERNAL, /GENERAL. (Refer to Paragraph 2.7 
for description of defaults.) 
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The deposit command writes (deposits) <data> into the address 
specified. The address space used will depend on the qualifiers 
specified with the command. If no qualifiers are used, the current 
address type default will determine the address space to be used. 


Response: <CR> <LF> <input prompt> 


The <address> argument may also be one of the symbolic addresses 
defined in Table 2-2. 


Table 2-2 Deposit Symbolic Addresses 


Symbol Definition 
PSL Deposits to the processor status longword 
PC Deposits to the program counter (general 


register F) 


SP Deposits to the stack pointer (general 
register E) 


+ Deposits to the location immediately following 
the last location referenced. For physical and 
virtual references the location referenced 
will be the last address plus n, where n = 1 
for byte, 2 for word, 4 for longword, 8 for 
quadword. For all other address spaces, n is 
always equal to l. 


- Deposits to the location immediately preceding 
the last location referenced 


* Deposits to the location last referenced 

@ Deposits to the address represented by the 
last data examined or deposited. 

Example: 

E SP Examines stack pointer 

D @ <data> Deposits <data> to the location specified by 
the contents of the stack pointer. 

2.3.5 Enable DX1l: Command 


Syntax: Enable DXl: 
Qualifiers: None 


Enable console software to access floppy on those systems with 
dual floppies. 
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Response: <CR><LF> <INPUT-PROMPT> 


2.3.6 Examine Command (E) 
Syntax: EXAMINE [ <qualifier - list> ] [ <blank> <address> ] <CR> 


Qualifiers: /BYTE, /WORD, /LONG, SQUAD, /JNEXT, /VIRTUAL, 
/PHYSICAL, /ID BUS, /V BUS, /INTERNAL, /GENERAL. (Refer to 
Paragraph 2.7 for description of defaults.) 


The examine command reads and displays the contents of the 
specified <address>. If no <address> is specified, the current 
<default address> is examined. 


The <address> argument may also be one of the symbolic addresses 
defined in Table 2-3. 


Table 2-3 Examine Symbolic Address 


Symbol Definition 

PSL Displays the processor status longword 

PC Displays the program counter (general register 
F) 

SP Displays the stack pointer (general register 
E) 

+ Displays the location immediately following 


the last location referenced. 


- Displays the location immediately preceding 
the last location referenced 


* Displays the last location referenced 


@ Displays the location whose <address> is the 
last data examined or deposited. 


Response: <CR> <LF> <tab> <address space identifier> <address> 
<data> <CR> <LF> <input prompt> 


Sample responses (console output underlined) 


>>> EXAMINE/PHYSICAL 1234 


P 80001234 ABCDEF89 
>>> EXAMINE/VIRTUAL 1234 
P 90005634 91234567 


NOTE 
The translated physical address is 
displayed for virtual examines. 


>>> EXAMINE/G @ 
G BOBOB000 98765432; GPR @ 
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7 ee ee | Halt Command (H) 
syntax: HALT <CR> 


The halt command causes the VAX-11/78@ CPU ISP to stop instruction 
execution after completing execution of the instruction being 
executed, when the console presents the halt request to the 
VAX-11/78@ CPU. 


Response: (VAX-11/78@ CPU indicates it has stopped) <CR> <LF> 
<tab> HALTED AT <contents of VAX-11/78@ CPU PC> <CR> <LF> <input 
prompt> 


2.3.8 Help Command (HE) 
Syntax: HELP <CR> 


The console opens an indirect command file that displays a console 
help file, CONSOLE.HLP. The help file contains a description of 
all console commands and console abbreviation rules, and it lists 
the names of all other help files that may be displayed. 


Response: Help file printed on console terminal. 


2.3.9 Initialize Command (TI) 
Syntax: INITIALIZE <CR> 


This command causes VAX-11/780 CPU system initialization. 
Response: <CR> <LF> <tab> INIT SEQ DONE <cr> <LF> <input prompt> 


2.3.10 LINK Command (LI) 
Syntax: Link 


Qualifiers: None 


Link causes the console to begin command linking. Console prints 
reversed prompt to indicate linking. All commands typed by user 
are then stored in an indirect command file for later execution. 
Control C terminates linking. 


Response: <CR><LF><REVERSE-PROMPT> 
(Refer to Paragraph 2.9 for further details.) 


Zeek Load command (LO) 
Syntax: LOAD [<qualifier list>] <blank> <file specification> <CR> 


The load command is used to read file data from the console's 
floppy disk to the VAX-11/78@ main memory, or Writable Control 
Store (WCS). The applicable qualifiers are defined in Table 2-4. 
If no qualifier is given with the load command, physical main 
memory is loaded. 
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Table 2-4 Load Command Qualifiers 
Qualifier Definition 


/START: <address> This qualifier specifies a starting 
address for the load. If no start 
qualifier is given, the console will 
Start loading at address @Q. 


/WCS This qualifier specifies that the WCS is 
to be loaded. 


2.3.12 Perform Command (P) 
Syntax: Perform 


Qualifiers: None 


The perform command executes a file of linked commands previously 
generated by a link command. 


Response: <dependent on commands linked> 


23013 Quad Clear Command (Q) 
syntax: QCLEAR <blank> <physical address> <CR> 


The quad clear command clears the quadword at the <address> 
Specified. The command is used to clear an uncorrectable ECC 
error. The <address> is always interpreted as a physical main 
memory location. The <address> given is forced to a quadword 
boundary by the unconditional clearing of the three low-order 
address bits. 


2.3.14 Reboot Command (REB) 
Syntax: REBOOT 


Qualifiers: None 


This command causes a console software reload, without disturbing 
the VAX-11/7890. 


Response: <console start-up display> 
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263015 Repeat Command (R) 
Syntax: REPEAT <console command> <CR> 


A repeat command causes the console to repeatedly execute the 
specified <console command> until execution is terminated by a 
Control C (°C) (Paragraph 2.8). Any valid console command may be 
specified for <console command> with the exception of the repeat 
command. 


Response: Dependent on command specified. 


2.3.16 Set Command (SE) 
Syntax: SET <blank> DEFAULT [<blank> <default option>] <CR> 
or 
SET <blank> STEP [<blank> <step option>] <CR> 
or 
SET <blank> TERMINAL <blank> (f111: <count>! PROGRAM) 
<CR> 
or 
SET <blank> SOMM <CR> 
or 
SET <blank> CLOCK [<blank> (SLOW! FAST! NORMAL)] <CR> 
or 
SET RELOCATION: <data> <CR> 


Response: <CR> <LF> <input prompt> (for all commands) 


The set default command sets console default for radix of console 
numeric input and output, address type, and data length. The 
console will apply defaults when a console command does not 
explicitly specify radix, address type, or data length. A set 
default command with no options specified will set all default 
settings to the power-up state. Applicable default options are 
listed in Table 2-5. 


Table 2-5 Set Default Command Options 


Option Specification 


Address Default Physical Sets default addressing mode 
Options Virtual as specified 

General 

Internal 

ID Bus 

V Bus 
Data Default Long Sets default data length as 
Options Byte specified 

Word 

Quad 
Default Radix He x Sets default radix for terminal 
Options Octal numeric I/O to radix specified 
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The set step command sets the VAX-11/788 CPU processor clock mode 
to the mode specified. The applicable modes are listed in Table 
2-6 e 


Table 2-6 Set Step Command Options 
Option Specification 


Step Step Instruction Sets CPU clock mode to single 
instruction step mode 


Set Step Bus Sets CPU clock mode to single SBI 
cycle step mode 


Set Step State Sets CPU clock mode to single SBI 
time state step mode 


The set terminal command allows the selection of two parameters. 


a. Set Terminal Fill: <count> = The count specifies the 
number of fill characters to be added after special 
characters (e.g., prompts) are transmitted to the console 
terminal. 


b. Set Terminal Program = The console terminal enters the 
program I/O mode. 


The set clock command sets the VAX-11/78@ CPU clock to a frequency 
specified by one of the arguments (Fast, Slow, Normal) within the 
command where: 


Fast = 10.525 MHz 
Slow = 8.925 MHz 
Normal (or no argument) = 10.0 MHz 


The set SOMM command sets the Stop on Microbreak Match (SOMM) 
enable on the console interface board (CIB). When SOMM is set, if 
the contents of the VAX-11/78@ micro PC ever become equal to the 
contents of the microbreak match register (ID register 21), the 
CPU clock is stopped. 


The set relocation command deposits <data> to the console's 
relocation register. The contents of the relocation register are 
added to the effective address of all virtual and physical memory 
examines and deposits. 


Response: <CR><LF><input-prompt> 
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2.3.17 Show Command (SH) 
syntax: SHOW <CR> 


The show command will cause the console terminal to display: 


a. The current default settings for data length, address 
type, and radix of address and data inputs and outputs. 


b. The terminal fill character count. 


Cc. The VAX-11/78@ CPU status including the run/halt state 
and current clock mode setting. 


2.3.18 Start Command (S) 
The two start command formats are described below. 


Syntax: START <blank> <address> <CR> 


This format performs the equivalent of the following sequence of 
console commands: 


1. Performs a VAX-11/78@ CPU initialization (>>> INIT). 


2< <address> is deposited into the VAX-11/78@ PC (>>> 
DEPOSIT PC <address>). 


ce A continue function is issued to begin VAX-11/788 CPU 
instruction execution (>>> CONTINUE). 


Response: <CR><LF> (console enters program I/O mode) (for START) 
Syntax: START/WCS <blank> <address> 


This format performs the equivalent of the following sequence of 
commands: 


1. <address> is deposited to the VAX-11/78@ micro PC. 
2. CPU clock is started in free-running mode. 


Response: <CR><LF> <input prompt> (for START/WCS) 


2.3.19 Next Command (N) 
Syntax: NEXT [<blank> <count>] <CR> 


The next command causes the VAX-11/78@ CPU clock to step the 
number of times indicated by <count>. The type of step performed 
by the clock is determined by the current state of the CPU clock 
mode, as set by a previous set step command. A next command issued 
while the VAX-11/78@ CPU is in normal (free-running) mode will 
default to Single instruction step mode for the duration of the 
command. 
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The console enters program I/O mode immediately before issuing the 
step, and reenters console I/O mode as Soon as the step is 
completed. Step-dependent responses are displayed on the console 
terminal after the completion of each of the count steps as 
specified below. 


a. Single instruction step: 
<CR> <LF> <tab> HALTED AT <contents of PC> 


b. Single bus cycle step: 
<CR> <LF> <tab> CPT@ UPC = <contents of UPC> 


Cc. Single time state step: 
<CR> <LF> <tab> CPTn (where n = 1, 2, or 3) or 
<CR> <LF> <tab> CPT@ UPC = <contents of UPC> 


If no <count> is specified, one step is performed, and the console 
enters the space bar step mode. While in this mode, each 
depression of the space bar causes one execution of the _ step 
option currently enabled (i.e., bus cycle, time _ state, 
instruction). 


A next command with an argument will not enable the space bar 
feature. For example, NEXT 2 will cause two steps to be executed; 
the console will then prompt for another command. 


An input of any character except SPACE will cause an exit from the 
Space bar step mode. 


2.3.20 Test Command (T) 
Syntax: TEST [/COMMAND] <CR> 


This command invokes the microdiagnostic monitor program. If no 
/COMMAND qualifier is issued with the command, microdiagnostic 
execution begins immediately. If microdiagnostic testing is 
completed successfully (i.e., no errors detected) the console 
program is invoked automatically. 


The COMMAND qualifier is used to cause the microdiagnostic monitor 
to enter its command mode and wait for operator input before 
initiating microdiagnostic execution. 


Zi s2k Unjam Command (U) 
Syntax: UNJAM <CR> 


This command initiates an SBI unjam operation. 
Response: >>> 


2.3.22 Wait Command (WA) 
Syntax: WAIT <blank> DONE 


The wait command has no effect unless it 1S executed from an 
indirect command file. When it iS executed from an indirect 
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command file, it causes further execution of the command file to 
be suspended until one of the following occurs: 


a. A DONE Signal is received from a program running in the 
VAX-11/78@ CPU. On receipt of DONE, the console will 
resume execution of the command file. 


b. If the VAX-11/78@ CPU halts (or if the clock stops) and 
no DONE signal has been received, the console prints 
<@EXIT> and aborts execution of the remainder of the 
command file. 


Cx A Control C (“C) is entered on the console terminal, 
which causes the console to abort execution of the 
command file. 


Response: <CR> <LF> <input prompt> 


2éa%23 Indirect (@) Command 
Syntax: @ <filename> <CR> or @ DXl: <filename> <CR> 


This command causes the console to open the file specified by 
<filename> and begin executing console commands from the file. 
Execution continues until one of the following occurs: 


a. A WAIT DONE command is read from the file (Paragraph 
22.3022) % 


b. The end of the indirect file is reached. In this case the 
console prints <@EOF> and prompts for normal command 
input. 


Ci A “C is entered on the console causing it to abort 
execution of the indirect file. 


2.3.24 WCS Command (W) 
Syntax: WCS 


This command invokes the control store debugger, overlaying the 
console program. The console help file, WCSMON.HLP, contains a 
Summary of control store debugger commands. To print out this 
file, type @ WCSMON.HLP. 


Response: WCS> (Control store debugger prompt) 


2.4 COMMANDS PERFORMED WITH THE VAX-11/788 CPU RUNNING 

Most console commands require that the VAX-11/78@ CPU be halted to 
allow the command to be executed. However, some console commands 
do not require interaction with the VAX-11/78@ CPU, and may be 
executed with the VAX-11/78@ CPU running. These commands include: 


a. Show e. Halt 

b. Help ae Clear 

Cs Set commands G. Wait Done 
d. Examine /V Bus 
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Specifying any other console command while the VAX-11/78@8 CPU is 
running will cause the console adapter to reject the command and 
type out the following error message on the console terminal: 


<CR> <LF> ? CPU NOT IN CONSOLE WAIT LOOP, COMMAND ABORTED 
<CR> <LF> <INPUT PROMPT> 


2.5 COMMENTS WITHIN COMMANDS 

The console allows comments, preceded by an exclamation mark (!), 
to appear in any command line. When the console detects an 
exclamation mark, any remaining text in the command line is 
ignored. 


A comment may begin in any character position within a command 
line, including the first. 


Example (console output underlined) 


>>> ! THIS IS A VALID COMMENT <CR> 
>>> EXAMINE 1234 ! THIS IS ALSO A COMMENT <CR> 


2.6 CONTROL CHARACTERS AND SPECIAL CHARACTERS 
Table 2-7 contains a description of the control characters and 
special characters recognized by the console program. 

Table 2-7 Control/Special Character Descriptions 


Character Description 


CONTROL C (“C) Causes the suSpenSion of all repetitive 
console operations such as: 


a. Repeated command executions as 
a result of a repeat command 


b. SuccesSive operationS aS a 
result of a /NEXT qualifier 


Cs Delays resulting from a wait 
command 
d. SuccesSive steps resulting from 


a next command 


e. Aborts further execution of an 
indirect command file after 
current instruction is 


completed. 


CONTROL O (“O) Suppresses or enables (on a toggle basis) 
console terminal output. Console terminal 
output is always enabled at the next 
console terminal input prompt. 
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Table 2-7 Control/Special Character Descriptions (Cont) 


Character 


CONTROL U (“U) 


RUBOUT 


Carriage Return <CR> 


Description 


“U typed before a line terminator causes 
the deletion of all characters typed 
Since the last line terminator. The 
console echoes: 


“U <CR> <LF> 


Typing RUBOUT deletes the last character 
typed on an input line. Only characters 
typed since the last line terminator can 
be rubbed out. Several characters can be 
deleted in sequence by typing successive 
rubouts. The first rubout echoes aS a 
backslash (\) followed by the character 
that has been deleted. Subsequent rubouts 
cause only the deleted character to be 
echoed. The next character typed that is 
not a rubout causes another backslash 
(\) to be printed, followed by the new 
character to be echoed. 


Terminates a console command line. 
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2.7 COMMAND QUALIFIERS AND DEFAULTS 

Qualifiers are used within a command to specify the type of 
addressing and the length of data arguments. Defaults are applied 
by the console when a command doesS not contain a qualifier 
specifying address-type or data length. An operator can specify 
the radix of a numeric argument by the use of a <local radix 
override> prefixed to the argument. The console will interpret 
numeric arguments in the current default radix when an argument is 
not prefixed by a <local radix override>. 


Certain commands permit an address argument to be defaulted. The 
<default address> used by the console is the next address 
following the last virtual, physical, or register address accessed 
by an examine or deposit command. Note that the next address is 
dependent upon data length, since a byte reference updates the 
<default address> by 1, while a longword reference updates the 
<default address> by 4. 


The /NEXT qualifier allowS an examine or deposit command _ to 
operate on more than one address. 


26 led Address Type Qualifiers 

Address type qualifiers are used within a command line to specify 
the type of address argument as virtual, physical, ID’ Bus, V Bus 
or register address. The qualifiers for the respective types are: 
/VIRTUAL, /PHYSICAL, /ID BUS, /V BUS, /GENERAL, /INTERNAL. 


Virtual addresses that reference nonexistent or nonresident pages 
will cause the console to abort execution of the console command 


that referenced the virtual address. In each caSe an appropriate 
error message will be typed out on the console terminal. 


Example 

To examine virtual address 1234, type: 

EXAMINE/VIRTUAL 1234 <CR> 
Note that since some register addresses have mnemonic names that 
are unique and unambiguous, the /GENERAL qualifier need not be 
specified when mnemonic addresses such aS PC, or SP, are 
referenced. 


Example 


To examine the VAX-11/78@ PC, an operator could type either 
of the following statements: 


EXAMINE/GENERAL PC <CRD> or 


E PC <CR> or 
E GENERAL F <CR> 
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2.7.2 Address Type Defaults 

The console applies an address type default to any command that 
requires an address argument and does not contain an address 
qualifier. The default applied can be set by using the set default 
command. 


Example 
The command: 
SET DEFAULT VIRTUAL <CR> 
will cause the console to default to virtual addressing for 
any console command that requires an address argument, but 
does not contain an address type qualifier. Thus, the command 


EXAMINE 1234 would type out the contents of virtual address 
1234. 


22753 Data Length Qualifiers 

Data length qualifiers are used within a command line to specify 
the length of the data quantity associated with the command. Data 
length may be specified as either byte, word, longword, or 


quadword by means of the /BYTE, /WORD, /LONG, /QUAD qualifiers, 
respectively. 


Example 

The command: 

EXAMINE/BYTE 1234 <CR> 

will type out the byte at address 1234. 
Since VAX-11/78@ CPU general and processor registers are longword 
quantities, all register references will default to longword data 


length, regardless of the current setting of the data length 
default. 


2.7.4 Data Length Defaults 
The console applies a data length default to any command that 
references data and does not contain a data length qualifier. The 
default applied can be set using the set default command. 
Example 

The command: 


SET DEFAULT WORD <CR> 


will cause the console to default to word data length. 
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The command: 
EXAMINE 1234 <CR> 


will then reference the word which has its first byte at 
address 1234. 


Since all VAX-11/78®8 CPU general and processor registers are 
longword quantities, all register references will default to 
longword data length, regardless of the current setting of the 
data length default. Word length must be specified when accessing 
Unibus device registers. 


2.7.5 Qualifiers for RADIX 

The radix of console output for a command can be sepcified by a 
qualifier (/OCTAL or /HEX). The qualifier will override the 
current default radix. 


2210 Defaults for RADIX 

The default radix for console numeric inputs and outputs is 
selectable as either HEX or OCTAL via the SET DEFAULT HEX or SET 
DEFAULT OCTAL command. 


2.7.7 Local Radix Override 

It is frequently convenient to specify an address or data argument 
in a radix different from the current default radix. The console 
allows the current default radix to be overridden by including a 
<local radix override> as a prefix to any numeric argument. A 
<local radix override> can be any one of the following: 


% O (percent O) for octal arguments 
$ X (percent X) for hexadecimal arguments 


The local radix override must appear as the two leftmost 
Characters of the numeric argument it modifies, and must not be 
separated by spaces or tabs from that argument. 


Example 


Assuming that the current default radix is octal, the 
operator can deposit the octal value 3456 into the 
hexadecimal address 12A4 using <local radix override> as 
follows: 


DEPOSIT %X12A4 3456 


2.7.8 Default Address Facility 

Each time an examine or deposit command is executed, the console 
computes the address of the next memory location following the 
location referenced by the command. The address of the next memory 
location is termed the <default address>, Since an examine command 
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that does not specify an address will reference the next address 
by default. The console computes the <default address> as follows: 


<default address> = <address used by last examine or deposit 
command> + n, where n is 

1 for byte references 

2 for word references 

4 for longword references 

8 for quadword references 


The following example shows a sequence of console commands, and 
the value taken by the default address after each command is 
executed. Note that the next address is data length dependent, 
since a byte reference updates the <default address> by 1, while a 
longword reference updates the <default address> by 4. 


Example of default address facility (all numbers are hex): 


Command <default address> after execution 
EXAMINE/BYTE 2341 2342 

EXAMINE/WORD 

(uses <default address> 2342) 2344 

EXAMINE/LONG 

(uses <default address> 2344) 2348 

EXAMINE/GENERAL @Q general register 1 (Rl) 
EXAMINE/GENERAL D general register E (SP) 

EXAMINE PC general register @ (R@) 


Note that the <default address> is R@ following a PC reference. 


2.7.8.1 Specifying Default Address in a Command -- The symbol (+) 
can be used as an address argument in a deposit or examine command 
to represent the <default address>. This symbol permits depositing 
to (or examining) Successive location without typing the address 
argument after the first deposit. 


Example 


To toggle-in a program starting at address 123456, the 
following deposit commands can be used: 


DEPOSIT 123456 <DATA> 
DEPOSIT + <DATA> 
DEPOSIT + <DATA> 


Each deposit command, after the first, writes the <DATA> into 
the next successive memory location. 


2.7.8.2 Last Address Notation -- The last address referenced 
(virtual, physical, or register) by an examine or deposit command 
is denoted by an asterisk (*). The LAST ADDRESS may be used as an 
argument to an examine or deposit command by typing an asterisk in 
place of the address argument. 
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Example 

The command: 

EXAMINE 1234 <CR> 

will type out the contents of location 1234. 

If the next command issued is 

DEPOSIT * 356 <CR> 

the console will deposit the number 356 into location 1234. 
Examine and deposit commands to VAX-11/78@ CPU general and 
processor registers will replace the <last address> with the 
register address. Mnemonic register names are translated into 
register addresses by the console. 
2.7.8.3 Preceding Address Notation -- The symbol - (minus sign) 
Can be used aS an address in a deposit or examine command to 
specify the location immediately preceding the last location 
referenced. 
2.7.8.4 Use of Last Data as an Address Argument -- The symbol @ 
can be used as an <address> in a deposit or examine command. The 


last <data> deposited or examined will be used as the address. 


2.7.9 NEXT Qualifier 
Syntax: SLASH NEXT [:<COUNT>] 


The /NEXT qualifier permits examine and deposit commands’ to 
operate on multiple sequential addresses. 


The <count> argument specifies the number of additional executions 
of the command to be performed after the initial execution. The 
default value for <count> iS one. 
Example 1 

The command: 

EXAMINE/BYTE 1230/NEXT: 2 


is evaluated by the console as follows: 


Ls The console initially evaluates the command and applies 
any applicable default values. 


2% The command, with applied defaults, is executed. The 


console types out the contents of location 1239, and 
updates the <default address> to 1231. 
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3. The /NEXT switch is now evaluated by the console. The 
console repeats the command operation the number of times 
indicated by the <count> argument. Each execution uses 
the <default address> for its address argument and 
updates the <default address> afterwards. In this 
example, locations 1231 and 1232 are successively typed 
out. The final value of the <default address> will be 
1233. 


Example 2 
If the command: 
EXAMINE/NEXT:2 <CRD> 
is issued following the command in the previous example, the 
contents of locations 1233, 1234, and 1235 will be typed out. 
Since the examine command does not contain an address 
argument, the initial execution of the command will use the 


Current <default address>, which was 1233, following the 
command in the previous example. 


Note that when uSing the /NEXT qualifier to examine or deposit 
succesSive VAX-11/788 CPU general registers, the NEXT register 
after the PC is defined to be R@. 
Example 3 

The command: 


EXAMINE/NEXT:5 GENERAL D 


will type out the contents of R13, SP, PC, RO, Rl, and R2, in 
that order. 


2.8 COMMAND REPEAT FACILITY 
The command repeat facility is provided to allow commands to be 
executed repeatedly so that CPU logic invoked by console commands 


can eaSily be scoped. The following paragraphs describe the repeat 
facility commands and capabilities. 


2.8.1 Repeating Commands 
Example 


The command: 
REPEAT EXAMINE 1234 <CR> 


will continuously examine and display the contents of 
location 1234. 


Once initiated, repeated execution continues until terminated by 
the operator typing Control C (*C) on the console keyboard. 
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2.9 COMMAND LINK FACILITY 

The console's command link facility allows successive commands to 
be linked by the console into a single executable list of 
commands. Once a list of linked commands is constructed, the list 
can be executed one pass at a time, or executed continuously. 


2.9.1 Link Facility Operation 

Commands are linked by entering LINK on the console terminal, 
cauSing the console to enter the link mode. LINK is then followed 
by the desired commands. The LINK command is entered only at the 
beginning of the command string (i.e., at the beginning of the 
initial command line). Commands to be linked must be entered 
one-per-line, with each command line terminated by a <CR>. The 
console then returns a link mode prompt (<<<) requesting the next 
command. The linking operation is terminated by entering a Control 
C on the console. 


As the command string is entered on the console, the commands are 
stored in dedicated sectors (limit of 18 sectors) on the floppy 
disk (RX@1). When the command string is executed, the string is 
treated as if it were an indirect command file (i.e., command 
retrieved, parsed, executed, and the next command. retrieved, 
etc.). 


The console does not execute commands being linked until a PERFORM 
command is issued. Once the input of a list of linked commands has 
been terminated, no further commands can be added to the commands 
already linked. 


The command string can be executed one pass at a time or 
continuously by means of the PERFORM command. If the PERFORM 
command 1S entered after the Control C to terminate the string, 
the string will execute only one pass. However, if PERFORM is 
entered before the Control C, that command becomes part of the 
command list and causes continuous execution of the command list. 


Should a linked command be entered incorrectly, the console will 
output an appropriate error message when the command containing 
the syntactic error is executed. Typing a Control U ("“U) while 
linking commands will cause the console to reject only the current 
command line. 


2.9.2 Link Facility Usage 
Syntax: LINK 
COMMAND <CR> 
COMMAND <CR> 
<*C> 
Response: Dependent on command list. 
Example 


The operator wishes to repeatedly examine the contents of a 
device register after VAX-11/780 CPU initialization. Since 
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the CPU initialization requires a certain amount of time to 
complete, a delay must be inserted between the initialize and 
examine commands. The sequence of commands is as_ follows 
(console output is underlined). 


>>> LINK INITIALIZE <CRD> LINK causes the console to 
enter the link mode and begin 
linking. 

<<< DELAY 5 <CR> Delays five clock ticks to 
allow initialize time to 


complete. 


<<< EXAMINE/LONG FFFFABBC <CR> Examine command is entered into 
String. 
<<< PERFORM <CR> <C> PERFORM is entered prior to 


linking termination. 
>>> PERFORM <CR> Initiates execution. 


P FFFFABBC 12A9@0123 
P FFFFABBC 12A9@123, etc. Command String executed 
continuously. 


2.19 CONSOLE MODE CHANGE 

The console I/O mode escape sequence causes the console to switch 
from console to program I/O mode. The escape sequence to program 
I/O is: 


SET TERMINAL PROGRAM <CR> 


In addition, the console commands START, CONTINUE, and NEXT also 
enable program I/O mode. 


The program I/O mode eScape sequence causes the console to switch 
from program to console I/O mode. The escape sequence to console 
I/O is: 


Control P (“P) 


Note that Control P is not recognized by the console if the 
console power switch 1S in either the REMOTE DISABLE position or 
the LOCAL DISABLE position. 


2.11 VMS COMMUNICATION WITH CONSOLE FLOPPY DISK 

VMS must be able to read and write the console subsystem's floppy 
disk drive. These functions are available only when the console is 
in program I/O mode. The following set of commands are supported 
by the console software. 


a. Write sector -- VMS supplies track, Sector, and 128 bytes 
of data. Console returns status upon completion of write. 
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b. Read sector -- VMS supplies track and sector. Console 
returns 128 bytes of data, and status of read operation. 


Cx Read floppy status -- Console returns floppy status. 


d. Write sector with deleted data mark -- VMS supplies track 
and sector (no data required). Console returns status 
upon completion of the write. 


e. Cancel floppy function -- Console aborts current floppy 
function. 


The following floppy functions will not be directly available to 
VMS: empty silo, fill silo, read error register, initialize. 


While VMS initiated floppy functions are in progress, operator 
terminal I/O is not disabled. Terminal I/O may be interspersed 
with floppy I/O. 


Once a floppy function is initiated, no other floppy commands will 
be issued by VMS until the function is complete. The only 
exception is the command cancel floppy function, which may be 
issued at any time. 


The floppy functions described in this document will only be 
available to VMS when the console is in program I/O mode (i.e., 
the console terminal is being uSed as the system operator's 
terminal). 


NOTE 
In the following protocols, two hardware 
side-effects are implied: 


1. Each time VMS loads the transmit 
buffer (TXDB), the TX ready bit in 
the transmit status register (TXCS) 
is automatically cleared. TXDB is 
only loaded by VMS, and only when TX 
ready is set. TX ready is explicitly 
set by the console when the console 
is ready to accept another transfer 
through TXDB. 


2. Each time VMS reads the receiver 
buffer (RXDB), the RX done bit in 
the receiver status register (RXCS) 
will automatically clear. RXDB is 
only read by VMS, and only when RX 
done is set. RX done is explicitly 
set by the console each time the 
console has loaded RXDB with a 
character for VMS. 
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2.11.1 Floppy Function Protocol 
A. Write sector/write deleted data sector 


1. 


12. 


B. Read 


VMS puts the write sector or the write deleted data 
sector command into TXDB. 


The console takes the write command, and sets TX 
ready in TxCs. 


VMS puts a Sector number into TXDB. 


The console takes the sector number and sets TX 
ready. 


VMS puts a track number into TXDB. 

The console takes the track number and sets TX ready. 
VMS puts a byte of data into TXDB. 

The console accepts a byte of data and sets TX ready. 
Steps 7 and 8 are done 128 times for write sector. 
Steps 7 and 8 are skipped for write deleted data 
sector. 

The console initiates a floppy write function. 

The floppy write is completed. 

The console sends a floppy function complete message. 
The floppy function complete message consists of 
loading RXDB bits 8--11 with a select code of 2, and 
bits @--7 with the floppy status byte. 


VMS receives the floppy function completed message. 


sector 
VMS puts the read sector command into TXDB. 


The console takes the read command, and sets TX ready 
in TXCS. 


VMS puts a sector number into TXDB. 


The console takes the sector number and sets TX 
ready. 


VMS puts a track number into TXDB. 
The console takes the track number and sets TX ready. 
The console initiates a floppy read function. 


The floppy read is completed. 
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ll. 


sar 


The console sends a floppy function complete message. 
The floppy function complete message consists of a 
select code of 2 in bits 8--11 of RXDB, and a floppy 
status byte in bits @--7 of RXDB. 


VMS receives the floppy function completed message. 


The console puts one byte of data in RXDB and sets RX 
done. 


VMS accepts one byte of data from RXDB. Steps 11] and 
12 are done 128 times. When the 128th byte is 
accepted by VMS, the read is complete. 


NOTE 
If a floppy error occurs on Step 8, 
Steps 11 and 12 will be skipped. 


Cx Read status 


ig VMS puts the read floppy statuS command in TXDB. 

2s The console takes the read status command and sets TX 
ready in TXCS. 

3% The console gets the floppy status from last floppy 
function performed. 

4. The console puts a floppy function complete message, 
with the floppy status, into RXDB and sets RX done. 

oe VMS reads the floppy status. 

D. Terminate floppy function 

eg VMS puts the cancel floppy function command in TXDB. 

2. The console takes the cancel floppy function. 

3. The console terminates the floppy function in 
progress, if any. 

4. The console sets TX ready in TXCS. 

2.12 MISCELLANEOUS CONSOLE COMMUNICATIONS 


The console software will support certain additional functional 
communications from VMS and the diagnostic supervisor (VMS/DS). 


A. Examine console memory -- VMS supplies an offset from the 
console-supplied base address of examinable memory space. 
The console returns the examine code and the contents of 
the requested byte. 


Examinable Console Memory Space 
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(Octal Offset from 37600(8) -- FIRSTF) 


+145 
+146 
+147 
+150 
+151 
+152 
+153 
+155 


B. 


2.13 


Warm-Start flag 

Cold-start flag 

APT-load flag 

Last setting of remote and disable 
Auto-restart flag 

PCS version 

WCS primary version 

FPLA version 


Software communication codes 


Ise 


Software done -- VMS issues thisS code to cause the 
console to resume execution of an indirect-command 
file that has been suspended due to a wait done 
command. 


Warm restart boot command -- The console will boot 
the VAX-11/789@. 


Clear warm-Start and cold-sStart flags -- VMS/DS 
issues these codes when the VAX has 
restarted/rebooted successfully. The console clears 
the associated flags. 


NOTE 
The cold and warm restart flags are used 
by the console to prevent infinite loops 
when a warm reStart results in a 
VAX-11/786 error halt. 


COMMUNICATION REGISTER FORMATS AND SELECT CODES 

The LSI-1l processor communicates with the VAX-11/788 CPU via two 
registers on the console interface board. Figure 2-1 shows the 
register formats and select codes. 


24 23 16 15 14131211 08 07 00 


FIELD FIELD 


24 23 1615141312 11 08 07 


OL-11 FIELD FIELD 


TK-0742 


Figure 2-1 Communication Register Formats and Select Codes 
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Select Code 
4) 


1 


select Field Values (in hex) 


Device 


Operator's terminal 


Floppy drive @ (data) 


Floppy function complete 


Examine console memory 


Floppy drive @ (command) 


Misc. communication 


NOTE 
Code 5 (protocol error) 
console when one 
occurs: 


a Another floppy command 


Data Field Values 


®@ through 7F ! 


ASCII data 


@ through FF -- binary data 


(floppy status) 


Address offset/contents of 


address 

@ = read sector 

l1 = write sector 

2 = read status 

3 = write deleted data 
sector 

4 = cancel floppy function 

5 = protocol error 

1 = software done 

2 = boot VAX-11/78@ 

3 = clear warm-sStart flag 

4 = clear cold-Start flag 


cancel floppy function) 
by VMS before a previous command is 


completed. 


is sent by the 
of the 


following 


(except for 


is issued 


2 The console gets a floppy drive @ 


code (DATA) 
command. 
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when 


expecting a 


2.14 FLOPPY STATUS BYTE DEFINITION 

The floppy status byte is used by VMS to determine the success or 
failure of a read or write operation. The floppy status byte is 
sent to VMS at the completion of a read, write, or read status 
operation. The select code is always the floppy function complete 
(code 2). The status bit assignments are shown in Figure 2-2. 


ae 


16 


15 1211 08070605 03020100 


coef [Tee | TT 


CRC ERR 
PARITY ERROR 
INIT DONE 
DELETED DATA 
ERROR 


TK-0745 


Figure 2-2 Floppy Status Bit Assignments 


NOTE 
The status bit assignments are identical 
to those supplied by the floppy 
controller, except for bit 7. Bit 7 
corresponds to bit 15 of the floppy's 
RXCS register. 


2eL5 REMOTE CONSOLE ACCESS COMMAND SET 

A special set of commands is included in the console command 
language of systems that use the remote diagnostic facility to 
facilitate console access from a remote terminal or computer. 
Commands can be initiated only on the terminal in control, 
according to the five-position key switch. The remote access 
command set provides for: 


a. A talk mode, to allow communication between local and 
remote terminal operators (enable talk). 


b. A copy control, to permit suppressing or enabling typeout 
on the local terminal while a remote operator is in 
control (enable/disable local copy). 


Cs A method of transferring control of the console between 
the local and remote operators (enable local control). 
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d. A method of controlling the echo of characters to the 
remote terminal while in talk mode (enable/disable echo). 


e. A method of suppressing lost carrier error messages 
caused by a loss of carrier on the remote line 
(enable/disable carrier error). 


£. A method of enabling and disabling use of the console 
subsystem floppy disk (enable/disable local floppy). 


g. A method of enabling and disabling use of the remote 
floppy disk (enable/disable remote floppy). 


26152) Enable Talk Mode Command 
Syntax: ENABLE <blank> TALK <CR> 


The enable talk command puts the console into talk mode. While in 
talk mode, characters typed on the remote keyboard are typed on 
the local terminal, and vice versa. The console does not echo 
characters back to the originating keyboard, unless the talk mode 
echo feature has been enabled. No console commands are recognized 
while in talk mode. 


Talk mode is terminated by typing the console escape character 
(*“P) on the terminal in control. When talk mode is terminated, 
console mode is enabled. 


Entering talk mode causes the console to enable the remote serial 
interface and assert the data terminal ready signal to the data 
set. All terminal I/O to a program running in the VAX-11/786 CPU 
is disabled while the console is in the talk mode. 
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2.15.2 Enable/Disable Echo Command 
Syntax: (ENABLE ! DISABLE) <blank> ECHO <CR> 


The enable echo command will cause the console to echo characters 
typed on either the remote or local keyboards while in talk mode. 
The disable echo command causes the console to Suppress echo of 
characters typed on both keyboards. 


Enable and disable echo are issued while the console is in console 
mode, but do not have any effect until talk mode is entered. A 
disable echo is automatically done each time the console keyswitch 


is put in the LOCAL/DISABLE position, and on power up of the 
console. 


261543 Enable/Disable Local Copy Command 
Syntax: (ENABLE ! DISABLE) <blank. LOCAL <blank> COPY 


The enable local copy command causes the local terminal to print a 
copy of all output directed to the remote terminal. The disable 
local copy command disables the local terminal from getting a copy 
of output directed to the remote terminal. 


Local copy is automatically disabled each time the console 
keyswitch is turned to the LOCAL or LOCAL/DISABLE position and on 
power up of the console. Local copy is automatically enabled each 
time the console keyswitch is placed in the REMOTE/DISABLE 
position. 


2ei1544 Enable Local Control Command 
Syntax: ENABLE <blank> LOCAL <blank> CONTROL <CR> 


An enable local control command, issued by the remote terminal 
operator while the console keyswitch is in the REMOTE position, 
transfers control of the console to the local terminal operator. 
(Normal remote operation locks out the local terminal.) This 
allows a local operator to take control of the console and the 
VAX-11/788 CPU, while the remote link is maintained. The remote 
operator may regain control of the console by typing a Control P 
on the remote keyboard. 


An enable local control command issued from the local terminal has 
no effect. Local control is automatically enabled when the console 
keyswitch is placed in the LOCAL or LOCAL/DISABLE position, and 
also on console power up. 


Zeit de5 Enable/Disable Carrier Error Command 
Syntax: (ENABLE ! DISABLE) <blank> CARRIER <blank> ERROR <CR> 


The enable carrier error command causes the console to print the 
message ?CARRIER LOST each time a loss of carrier on the remote 
line is detected. Also, if the console keyswitch is in the LOCAL 
or REMOTE position, the console enters talk mode, enabling data 
terminal ready on the modem. 
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The disable carrier error command causes the console to inhibit 
the carrier lost message, and prevents a transition to talk mode. 
An enable carrier error is automatically done on console power up, 
and whenever the console keyswitch is placed in the LOCAL or 
LOCAL/DISABLE position. 


2.15.6 | ENABLE/DISABLE LOCAL Floppy Command 
Syntax: (ENable!DIsable) <BLANK>Local<BLANK>FLoppy 


Enable local floppy will cause the directory of the local floppy 
to be searched first, in an attempt to open a file. If the file is 
not found, the remote floppy directory is searched. Note that in 
terms of the console software, the remote floppy is a virtual 
device. It may be a floppy or it may be some other storage device. 


Disable local floppy will cause only the directory of the remote 
floppy to be searched in an attempt to open a file. 


An enable/disable local floppy command affects protocol operation 
only (transmission format). 


2.16 CONSOLE ERROR MESSAGES 

This paragraph describes all console error message formats and 
their interpretation. All console error messages are prefixed by a 
question mark to distinguish them from informational messages. 


2.16.1 Syntactic Error Messages 
2<TEXT STRING> IS INCOMPLETE 
The <TEXT STRING> is not a complete console command. 


?<TEXT STRING> IS INCORRECT 
The <TEXT STRING> is not recognized as part of a console command. 


?FILE NAME ERR 

A <FILENAME> given with a LOAD or @ command cannot be translated 
to RAD5@. One of the characters is not translatable to RAD5@ or 
the number of characters allowed is exceeded: six characters for 
file name, three for extension. 


2.16.2 Command Generated Error Messages 

?FILE NOT FOUND 

A <FILENAME> given with a LOAD or @ command does not match any 
file on the current floppy disk. This error can also be generated 
by a HELP or BOOT command if the help file or boot file is missing 
from the floppy. 


?NO CPU RESPONSE 
The console timed out while waiting for a response from a 
VAX-11/788 CPU microroutine. 


2?CPU NOT IN CONSOLE WAIT LOOP, COMMAND ABORTED 


A console command that required the assistance of the VAX-11/789 
CPU was issued when the CPU was not in the console service loop. 
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2?CPU CLOCK STOPPED, COMMAND ABORTED 
A console command that requires the CPU clock to be running was 
issued with the clock stopped. 


2? IND-COM ERR 
An indirect command file error was detected. This error is 
generated if: 


a. An indirect command line exceeds 8@ characters, 
b An indirect command line does not end with <CR> <LF>. 


2.16.3 Microroutine Error Messages 

The console uses various microcode routines in the VAX-11/788 CPU 
control store to perform console functions. The following errors 
are generated by microroutine failures. 


?MEM-MAN FAULT, CODE = XX 

A virtual examine or deposit caused an error in the memory 
Management microroutine. XX is a one-byte error code supplied by 
the memory management routine and defined in Table 2-8. 


NOTE 
Bit positions are numbered from the 
right. 


Table 2-8 Memory Management Error Code Definitions 


Bit Position Definition 

g Length violation 

1 Fault waS on a PTE reference 
2 Write or modify intent 

3 Access violation 

4--7 Ignored 


2MICROMACHINE TIME OUT 
This message indicates that the VAX-11/78@ micromachine has failed 
to strobe interrupts within the maximum time period allowed. 


?MIC-ERR ON FUNCTION 
An unspecified error occurred in the CPU while servicing a console 
request. Referencing nonexistent memory will cause this error. 


2?INT-REG ERR 

An error occurred while referencing one of the VAX-11/780 CPU 
internal (processor) registers. Specifying a register address that 
is too large will cause this error. 
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?MICROERR, CODE = XX 

An unrecognized microerror occurred. The code returned by the CPU 
is not in the range of recognized error codes. XX is the one-byte 
error code returned by the microroutine. 


2.16.4 CPU Fault Generated Error Messages 
2?INT-STACK INVLD 
The VAX-11/780 CPU interrupt stack was marked invalid. 


2?CPU DBLE-ERR HLT 
The VAX-11/78@ CPU has done a double error halt. 


?ILL I/E VEC 
An illegal interrupt/exception vector was encountered by the 
VAX-11/780 CPU. 


2NO USR WCS 
An interrupt/exception vector to WCS was encountered, and no WCS 
exists. 


2?CHM ERR 
A change-mode instruction was attempted from the interrupt stack. 


2.16.5 RX@1 Error Messages 

? FLOPPY ERR, CODE = X 

The console floppy driver (a part of the console software) 
detected an error. X iS an error code (in hexadecimal) and is 
defined in Table 2-9. 


Table 2-9 RX@1l Error Message Code Definitions 


Code Definition 

4) Floppy hardware error (1.e., CRC, 
parity, or a floppy firmware detected 
error). 

1 An open file command failed to find the 


specified file. 


2 The floppy driver queue is full. 

3 A floppy sector was referenced that is 
out of the legal range of sector 
numbers. 


?FLOPPY NOT READY 
The console floppy drive failed to become ready when booting. 


2NO BOOT ON FLOPPY 
The console attempted to boot from a floppy that does not contain 
a valid boot block. 


?FLOPPY ERROR ON BOOT 
A floppy error was detected while attempting a console boot. 
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2.16.6 Miscellaneous Error Messages 

INT PENDING 

This is not actually an error (note absence of ?). The message 
indicates that an error waS pending at the time that a console 
requested halt was performed. Type CONTINUE to clear interrupt. 


2?WARNING-WCS and FPLA VER MISMATCH 

The microcode in the WCS is not compatible with the FPLA. This 
message is printed on each ISP START or CONTINUE. However, no 
other action is taken by the console. 


?FATAL-WCS and PCS VER MISMATCH 


The microcode in the PCS iS not compatible with that in the WCS. 
ISP START and CONTINUE are disabled by the console. 


?REMOTE ACCESS NOT SUPPORTED 

This message is printed when the console mode switch enters a 
REMOTE position, and the remote support software is not included 
in the console. 


?TRAP -4, RESTARTING CONSOLE 
The console took a time-out trap. Console will restart. 


?UNEXPECTED TRAP 


Console trapped to an unused vector. Console reboots when operator 
types Control C. 


?QBLOCKED 


Indicates that the console's output queue is blocked. Console will 
reboot. 
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CHAPTER 3 
DIAGNOSTIC SUPERVISOR AND CONTROL 


This chapter describes the basic structure and operating 
Characteristics of the diagnostic supervisor. In addition, 
operator commands and execution control functions are described. 
This description is applicable to macro testing, and while many 
Similarities exist for the micros, this chapter does not include 
them (refer to Chapter 4). 


3.1 SUPERVISOR STRUCTURE OVERVIEW 

The diagnostic supervisor provides operator control and utility 
Support functions for three diagnostic runtime environments. The 
three runtime environments are: 


a. Cluster Environment (CE): This environment supports the 
CPU cluster and repair level I/O bus adapter diagnostic 
programs. The CE consists of program modules that provide 
utility services (i.e., error reporting, scope loops, 
etc.), initialization and test dispatch, and operator 
terminal interface. Additional modules provide load and 
script management. 


b. System Environment (SE): This environment Supports the 
repair level I/O subsystem diagnostic programs, and the 
device functional test programs. The SE provides the same 
runtime support functions as the CE. Program modules 
provide CPU cluster hardware interface support (i.e., 
real-time clock control, interrupt system control, I/0 
bus adapter control, etc.). 


oun User Environment (UE): This environment supports the I/O 
Subsystem functional level diagnostic programs that run 
under the VMS operating system aS a privileged user task. 


I/O services are provided primarily for functional level programs. 
This allows programs that can execute in an operating system 
environment, which restricts I/O access, to perform equally well 
in a standalone environment. 


The three supervisor environments are assembled into a common 
executable module that provides all necessary operator and program 
services. As shown in Figure 3-1, these services are implemented 
in two major functional areas: Command Line Interpreter (CLI) and 
Program Interface (PGI). 
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Figure 3-1 Basic Diagnostic Supervisor Structure 


The CLI interfaces to an operator (controlling) terminal and 
enables the operator to control the loading, sequencing, and 
execution of diagnostic test programs. The CLI monitors all 
control inrormation passing between the terminal and the 
supervisor. This information consists of Supervisor commands from 
the operator which control either supervisor or test program 
operation. The CLI directs control to the appropriate Supervisor 
service module according to the command supplied by the operator. 


The PGI provides common services required by all diagnostic test 
programs. These services include operator interaction, program 
control, error message formatting, memory management, and I/O 
request handling. Note that the operator can communicate with the 
diagnostic program only through a PGI message service or with the 
CLI directly. 


When the operator initiates diagnostic program execution (through 
the CLI), that program assumes control. Once program execution 
begins, the PGI handles all test information flowing between the 
terminal or the Unit Under Test (UUT) (i.e., QI/O-I/O driver 
interface) and a functional level program. For repair level 
programs, test information flows directly between the UUT and the 
diagnostic program (i.e., direct test program access to I/0 
registers). 


Test control information flow between the terminal and the 
diagnostic program consists mainly of test parameter requests and 
responses, while test information flow between the UUT and the 
program consists mainly of test stimuli and responses. 


The diagnostic program executes until the test sequence is 
completed, aborted, or the operator enters the appropriate control 
character, at which point control returns to the CLI. 


System errors not directly related to the UUT are handled by the 
Supervisor. Unless the program explicitly requests notification, 
these errors are transparent to the program and are reported 
directly to the operator. 
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3.2 CLI FUNCTIONAL MODULE DESCRIPTION 

The CLI consists of a tree-structured command decoder and several 
service modules that execute the operator's commands (e.g., 
loading a diagnostic program from the system device; altering the 
operational characteristics of the program; or driving the CLI 
through a script file). The command syntax is a subset of the 
console command language. 


Once a command line is interpreted, the CLI dispatches control to 
the appropriate service module. After the operator's command has 
been completed or aborted, control is returned to the CLI. Certain 
CLI service modules pass control to the diagnostic program, rather 
than back to the CLI. However, the CLI continues to monitor the 
operator's terminal for certain commands (e.g., “C). 


Se2ed Image Loader Module 

The image loader allows the operator to specify a load device and 
a file name for loading diagnostic programs. Depending on the 
environment (i.e., console, system, or user), the device media 
will be either the diagnostic load device (console floppy) or the 
system load device. 


3e2u2 Test Sequence Control Module 

The test sequence control module provides the operator with the 
capability to control the order in which tests within a program 
are executed. This is implemented by specifying test numbers in 
the run, start, and restart supervisor commands (Paragraph 3.4). 


32263 Script Processor Module 

Automatic test sequence control is achieved through the use of a 
script file. This script file is a line-oriented ASCII file that 
contains standard CLI supervisor commands. To allow for commenting 
on a command line, any text following a (!) on a line is ignored 
by the script processor. Blank lines and extraneous’ spacing 
characters are also ignored. 


A script file may contain CLI supervisor commands (Paragraph 3.5) 
only, or a combination of commands and program parameter 
responses. Generating script or parameter files is performed 
off-line using a standard editor system utility. 


3.3 PGI FUNCTIONAL MODULE DESCRIPTION 

The major function of the PGI module is to handle all information 
flowing between the operator's terminal or the UUT and _ the 
functional level I/O program. While a diagnostic program is 
executing, that program can call on the supervisor to supply 
various services. These services provide the program with the 
required common functions (e.g., memory allocation and mapping, 
I/O procesSing, operator terminal interfacing, error message 
formatting, and system error handling). 


Several of the functions the PGI provides are a subset of the VMS 
System services. For example, the supervisor provides the VMS 
queue I/O service so that user mode diagnostics may be executed 
Standalone as well as under VMS. 
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3631 Memory Management and Adapter Services 

All memory buffer allocation is performed by the diagnostic 
Supervisor. This enSures system integrity throughout the various 
operating environments. 


All necessary interfacing between the CPU and UUT will be handled 
by the diagnostic SuperviSor. 


Running standalone, the supervisor provides I/O services similar 
to those available under VMS. This provides a smaller standalone 
environment for running user mode diagnostics. Only a small kernel 
subset of VMS system services is provided. 


All functional level diagnostics perform device I/O as specified 
by the VMS operating system. However, in addition to the normal 
queue I/O functions, VMS provides special features that diagnostic 
programs can use if executing as privileged processes. On I/O 
completion, if requested and privilege permitting, raw status is 
deposited into a buffer specified by the program. This status 
contains all device registers and pertinent channel registers. A 
time stamp is also deposited into the status buffer. 


343%:2 Operator Terminal Services 

Since the diagnostic programs do not interface directly with the 
operator's terminal, the supervisor provides all required operator 
communication services for the diagnostic program. The program can 
perform operator dialogue through a supervisor service to allow 
testing of mechanical devices that require operator interaction. 


The terminal drivers within the service eliminate the need for the 
diagnostic programmer to be aware of the type of terminal 
currently used by the operator. 


The output to the operator, including error reporting, uses 
formatted ASCII output to simplify the program's message-Ssending 
routines. Conversion of binary data to ASCII display is handled by 
the diagnostic supervisor instead of the programmer. The formatted 
ASCII output syntax is the same as that used by VMS. 


35383 System Error Handling 

All system errors are intercepted and reported directly to the 
operator by the supervisor unless the program explicitly requests 
notification of exceptions or interrupts. 


3.4 SUPERVISOR COMMAND DESCRIPTIONS 

The following paragraphs describe the operator command and 
execution control functions provided by the diagnostic supervisor. 
Where appropriate, examples of command usage are included. 


3.4.1 Command Terms and Symbols 

Since the supervisor commands are a subset of the console 
commands, many of the console command terms and symbols are used 
in the symbolic supervisor command descriptions. The applicable 
characters are defined in Table 3-1. 
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Table 3-1 Term and Symbol Definitions 


Term/Symbol Definition 


! Used to indicate the Exclusive OR operation 
(i1.e., selection of parameters within a 
command line) 


( ) Used to indicate that one of the syntactic 
units of the expression is to be selected 


< > Used to indicate symbolic arguments, or 
Program functions to/from the operator 
terminal 

[ J Used to indicate that part of an expression 


is optional; e.g., WAIT [<blank> <count> ] 
indicates that the wait command takes an 
optional <count> argument 


<blank> Represents one or more spaces 

<tab> Represents one or more tabs 

<count> Represents a numeric count 

<XYZ - list> Indicates one or more occurrences from the 


category indicated by XYZ 


<address> Represents an address argument 

<data> Represents a numeric argument 

<qualifier> Represents a command modifier (switch) 

<input prompt> Represents the console's input prompt string 
>>> Console program input prompt character 

DS> Diagnostic supervisor prompt 

<CR> Represents a console terminal carriage return 
<LF> Represents a console terminal line feed 

/ Delimits a command from its qualifiers 

: Used aS a separator within a list 


Used as a Separator within a command line. 
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3.4.2 Command Description Segments 

Each supervisor command description is divided into three, four, 
or five descriptive segments, depending on the particular command. 
The descriptive segments are: 


a. Syntax: describes the command structure. 


b. Command description: a brief paragraph describing command 
operation, general restrictions, or available options. 


Cs Response: a description of the console program response 
to the specified command. 


d. Qualifiers: a list of applicable command modifiers. 
e. Options: a list of applicable command options. 


The descriptive segments use the terms and symbols defined in 
Table 3-1. Note that every command (or command line) must be 
terminated with a <CR>. 


3.4.3 Command Abbreviations 

Supervisor command words, Switches, and arguments may be 
abbreviated by typing only enough characters to uniquely identify 
each item. For example, the load command can be specified by L, 
while the start command requires a minimum entry of ST. 


3.4.4 Command Overview 
The supervisor operator commands are divided into the three 
following groups: 


a. Load/test sequence control: provides the operator with 
the capability of loading and sequencing diagnostic 
programs. 

b. Execution control: provides the operator with control of 


the operational characteristics of the diagnostic program 
and/or supervisor (e.g., looping, error reporting, etc.). 


Cx Debug/utility functions: provide the operator with debug 
and utility functions such as: breakpoints, examine, 
deposit, etc. 


The supervisors also Support operator terminal characteristics 
such as width, fill, etc. In addition, all control functions 
provided by the console (e.g., Control C) are also supported by 
the supervisor. 


3.5 SEQUENCE CONTROL COMMANDS 

The program/test sequence control commands provide the operator 
with the capability of loading and controlling the sequencing of 
diagnostic programs, as well as the capability of controlling the 
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sequence of test execution within a program. The Supervisor also 
provides for the execution of a single subtest, and if the pass 
count option is used, provides a loop-on-subtest capability. 


The submit command allows an entire diagnostic test session to be 
predefined by the operator. The Supervisor is then capable of 
performing the test session without operator assistance. 


Note that the symbolic argument <file spec> as used in the 
following subsection is defined as: 


dev unit : [UIC] filename . ext 


3¢5e1 Load Command 
Syntax: LOAD <file spec> [/PHYSICAL : <address>] <CR> 


The load command causes the specified file to be loaded into 
memory. The supervisor obtains sufficient information from the 
program. 


After a successful load, the Supervisor prints out the following 
message: Progname-r.p LOADED. 


Progname is the program name. This is the internal name which 
the supervisor extracts from the program header section. 


--r.p is the release version number and the DEPO (patch) 
number of the program. 


The optional PHYSICAL switch directs the image loader to attempt 
to load the program into physically contiguous memory starting at 
<address>. The <address> argument is normally accepted in 
hexadecimal format by default. 


38 0¢2 Start Command 
Syntax: START [/SEC : <section name>] -- [/TEST : <first>] 
[:<last> !/SUBTEST : <number>] ] -- [/PASS : <count>] <CR> 


The start command causes the program in memory to begin execution. 
As execution begins, the supervisor enters into a dialogue with 
the operator to determine the program specific parameters. (e.g., 
which units to test). The command switches and certain arguments 
are optional. 


The SECTION switch is program specific and not available for use 
with all programs. When a section is selected, only the tests that 
it contains will be executed. 
The TEST switch is used in two distinctly different ways. 

a. If the <first> and <last> arguments are specified, the 


Supervisor sequentially passes control to tests <first> 
through <last> inclusively. 
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b. If the <first> argument is combined with the SUBTEST 
Switch, program execution begins at the beginning of the 
<first> test and terminates at the end of SUBTEST 
<number>. 


If the SUBTEST switch is used in conjunction with the PASS switch, 
the operator is provided with a loop-on-sSubtest capability. If the 
optional PASS switch is not specified, a default <count> of one is 
assumed. 


If the TEST switch is not specified, all tests within the program 
are executed. If only the <first> argument is specified with the 
TEST switch, the <last> argument is assumed by default to be the 
highest numbered test within the program. 


34563 Restart Command 
Syntax: RESTART [/SEC: <Section name>] -- [/TEST : <first> 
[:<last> ! /SUBTEST : <number>]] -- [/PASS : <count> ] <CR> 


The restart command is Similar to the start command; however, the 
Supervisor does not enter into the parameter retrieval dialogue. 
This command requires that the program P-Tables have been 
previously setup with a start command. Switch syntax is identical 
to the start command switches. 


3.5.4 Run Command 
Syntax: RUN<file spec> [/SEC: <Ssection-name>]! -- [/TEST : <first> 
[ : <last>! -- /SUBTEST : <number> ]] [/PASS : <count>] 


The run command is equivalent to a load and start command 
sequence. (Refer to Paragraph 3.5.2 for a description of the 
optional switches.) 


33565 Control Characters and Special Characters 


Table 3-2 contains a description of the control and special 
characters recognized by the supervisor. 
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Table 3-2 Control/Special Character Descriptions 
Character Description 


Control C (“C) Returns program control to the supervisor 
which enters a command wait state. The 
operator may then issue any valid supervisor 
command. 


Control O (70) Suppresses or enables (on a toggle basis) 
console terminal output. Console terminal 
output iS always enabled at the next console 
terminal supervisor input prompt. However, 
the supervisor will override “O- and 
reinstate an active output status to the 
operator terminal when it is servicing 
system errors, CLI prompts, or forced 
messages. 


Control U (“U) “U typed before a line terminator causes the 
deletion of all characters entered since the 
last line termination. The console echoes: 
“U/<CR><LF> 


Rubout Typing rubout deletes the last character 
typed on the input line. Only characters 
entered since the last line terminator can 
be rubbed out. Several characters can be 
deleted in sequence by typing successive 
rubouts. The first rubout echoes as a 
backslash (\) followed by the character 
which has been deleted. Subsequent rubouts 
cause only the deleted character to be 
echoed. The next character typed that is not 
a rubout causes another (\) to be printed, 
followed by the new character to be echoed. 


Carriage Return (CR) | Terminates a command line. 


3.5.6 Continue Command 
Syntax: CONTINUE <CR> 


The continue command causeS program execution to resume at the 
point at which the program was suspended. This command is used to 
proceed from a breakpoint, error halt, or Control C Situation. 


3.5.7 Summary Command 
Syntax: SUMMARY <CR> 


The summary command causes the execution of the program's summary 
report code section which prints statistical reports. 
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3.5.8 Abort Command 
Syntax: ABORT <CR> 


The abort command executes the program's cleanup code and returns 
control to the supervisor, which enters a command wait state. At 
this point the operator may issue any command except restart or 
continue. 


3.5.9 Submit Command 
Syntax: SUBMIT <file spec> [/LOG : ON ! OFF] [/CONSOLE : ON! OFF] 
<CR> 


The submit command causes the supervisor to read a script file 
from any file-oriented device. The supervisor performs the 
functions outlined in the script file and then returns control to 
the operator at the console. 


The script file may contain any valid operator commands, including 
a submit command. However, a Submit command within a script file 
is considered a terminal command (i.e., the supervisor will close 
the current script and log files and open new ones as specified by 
the current command). 


If the LOG switch is specified as ON, a transcript of the indirect 
terminal dialogue is maintained in a file of the same filename as 
the script file with an extension of .LOG on the device where the 
script file is located. The default for this switch is OFF. 


If the CONSOLE switch is specified as ON, the terminal dialogue 
generated by the script file is printed on the operator's 
terminal. The default for this switch is ON. 


3.6 EXECUTION CONTROL COMMANDS 

This group of commands allows the operator to statically or 
dynamically alter the operational characteristics of the 
diagnostic program and/or the supervisor. These functions are 
implemented by flags that reside in both the Supervisor and the 
program. The event flags are located within the diagnostic program 
and are supported by VMS and the supervisor. 


These commands are used to control the printing of error messages, 
ringing the bell, halting and looping of the program, etc. Flags 
are provided that indicate to the supervisor which type of 
dialogue characteristics are desired by the operator. The operator 
also has access to a subset of the event flags that are available 
to the program. 


3.6.1 set Control Plag Command 
Syntax: SET [FLAGS] <argument list> <CR> 


This command sets the execution control flags specified by 
<argument list>; no other flags are affected. <argument list> is a 
String of flag mnemonics separated by commas. The applicable flags 
are described in Table 3-3. 
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Flag 


HALT 


LOOP 


BELL 


IE 


IE2 


IE3 


IES 


QUICK 


Table 3-3 Control Flag Descriptions 


Description 


Halt on error detection. When the program 
detects a failure, with this flag set, the 
Supervisor enters a command wait state after 
all error messages associated with the 
failure have been output. The operator may 
then continue, reStart, or abort the 
program. This flag takes precedence over the 
LOOP flag. 


Loop on error. When set, this flag causes 
the program to enter a predetermined scope 
loop on a test or subtest that detects a 
failure. 


Looping will continue until the operator 
returns to the supervisor by using “C. The 
operator may then continue, clear the flag 
and continue, restart, or abort the program. 


Bell on error. When set, this flag will 
cause the supervisor to output a bell to the 
operator whenever the program detects a 
failure. 


Inhibit error messages at level 1. When set, 
this flag suppresses all error messages 
except those that are forced by the program 
Or Supervisor. 


Inhibit error messages at level 2. When Set, 
this flag suppresses basic and extended 
information concerning the failure. Only the 
header information message (the first three 
lines) is output for each failure. 


Inhibit error messages at level 3. When set, 
this flag suppresses extended information 
concerning the failure. The header and basic 
information messages are output for _ each 
failure. 


Inhibit summary report. When set, this flag 
Suppresses statistical report messages. 


Quick verify. When set, this flag indicates 


to the program that the operator desires a 
quick verify mode of operation. 
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Flag 


SPOOL 


TRACE 


LOCK 


OPERATOR 


PROMPT 


ALL 
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Table 3-3 


Control Flag Descriptions (Cont) 
Description 


List error messages on line printer. When 
set, this flag causes the Supervisor to 
direct all program messages to the line 
printer. In the VMS environment, the 
messages are not actually printed but 
entered into a file on disk (not yet 
implemented). 


Report the execution of each test. When Set, 
this flag causes the supervisor to report 
the execution of each individual test within 
the program as the Supervisor dispatches to 
that test. 


Lock in physical memory. When set, this flag 
disables the program relocation function. 
Self-relocating programs are then locked 
into their current physical memory space. 


Operator present. When set, this flag 
indicates to the Supervisor that operator 
interaction is possible. When cleared, the 
Supervisor takes appropriate actions to 
ensure that the test session bypasses any 
tests that require manual intervention. 


Display long dialogue. When set, this flag 
indicates to the supervisor that the 
operator wants to see the limits’ and 
defaults for all questions printed by the 
program. 


All flags in this list. 


Clear Control Flag Command 


Syntax: CLEAR [FLAGS] <argument list> <CR> 


The clear command clears the flags specified by <argument list>; 
no other flags are affected. The <argument list> is a string of 
flag mnemonics separated by commas. The supported arguments are 
described in Table 3-3. 


3.6.3 
syntax: 


Set Control Flag Default Command 
SET FLAGS DEFAULT <CR> 


This command returns all flags to their initial default status. 
The default flag settings are OPERATOR and PROMPT. 
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3.6.4 Show Control Flags Command 
Syntax: SHOW FLAGS <CR> 


This command causes the display of all execution control flags and 
their current status. The flags are displayed as two mnemonic 
lists: one for set flags, one for clear flags. 


3.6.5 Set Event Flags Command 
Syntax: SET EVENT [FLAGS] <argument list> ! ALL <CR> 


This command sets those event flags specified by <argument list>; 
no other event flags are affected. The <argument list> is a string 
of flag numbers in the range 1--23, separated by commas. The 
optional ALL may be specified instead of <argument list>. 


Event related services are provided by the supervisor to provide 
intraprocess synchronization and signaling by means of event 
flags. Event flags are located in clusters of 32 flags each. 


The supervisor provides two event flag clusters. Event flags are 
Specified by the numbers @--63. However, flags 24--31 are 
restricted for use by VMS. The operator has the capability to 
interactively set and clear flags 1--23. 


Note that numbers 32--63 are for program use. Number @ is used by 
the supervisor. 


3.6.6 Clear Event Flags Command 
Syntax: CLEAR EVENT [FLAGS] <argument list> ! ALL <CR> 


This command clears those event flags specified by <argument 
list>; no other event flags are affected. The optional ALL may be 
Specified instead of <argument list>. 


3.6.7 Show Event Flags Command 
Syntax: SHOW EVENT [FLAGS] <CR> 


This command causes the display of a list of the event flags 
currently set. 


3.7 DEBUG AND UTILITY COMMANDS 

This group of commands provides the operator with the ability to 
alter diagnostic program code. The supervisor allows up to 15 
Simultaneous breakpoints within the program. The operator can also 
examine and/or modify the program image in memory. Optionally, a 
modified image can be written to a load device so that patching 
need occur only once. 


Another feature allows the operator to unconditionally list any or 
all of the program error messages. 


3.7.1 Set Base Command 
Syntax: SET BASE <address> <CR> 
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This command loads the address specified into a software register. 
This number is then used as a base to which the address specified 


in the set breakpoint, clear breakpoint, examine, and deposit 
commands is added. The set base command is useful when referencing 
code in the diagnostic program listings. The base should be set to 
the base address (see the program link map) of the program section 
referenced. Then the PC numbers provided in the listings can be 
used directly in referencing locations in the program sections. 


NOTE 
Virtual address = physical address 
(normally) when memory management is 
turned off. 


33.752 Set Breakpoint Command 
Syntax: SET BREAKPOINT <address> <CR> 


This command causes control to pass to the supervisor when program 
execution encounters the <address> previously specified by this 
command. A maximum of 15 simultaneous breakpoints can be set 
within the diagnostic program. 


3.7.3 Clear Breakpoint Command 
Syntax: CLEAR BREAKPOINT <address> ! ALL <CR> 


This command clears the previously set breakpoint at the memory 
location specified by <address>. If no breakpoint existed at the 
specified address, no error message is given. An optional argument 
of all clears all previously defined breakpoints. 


3.7.4 Show Breakpoints Command 
Syntax: SHOW BREAKPOINTS <CR> 


This command displays all currently defined breakpoints. 


3.765 Set Default Command 
Syntax: SET DEFAULT <argument list> <CR> 


This command causes setting of default qualifiers for the examine 
and deposit commands. The <argument list> argument consists of a 
data length default and/or radix default qualifiers. If both 
qualifiers are present, they are separated by a comma. If only one 
Gefault qualifier is specified, the other one is not affected. 
Default defaults are HEX and LONG. Default qualifiers are: 


Data Length: Byte, Word, Long 
Radix: Hexadecimal, Decimal, Octal 


3.7.6 Examine Command 
Syntax: EXAMINE [ <qualifiers>] [<address>] <CR> 


The examine command displays the contents of memory in the format 
described by the qualifiers. If no qualifiers are specified, the 
default qualifiers set by a previous default command are 
implemented. The applicable qualifiers are described in Table 3-4. 
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Table 3-4 Qualifier Descriptions 


Qualifier Description 

/B Address points to a byte 

/W Address points to a word 

/L Address points to a longword 
/X Display in hexadecimal radix 
/D Display in decimal radix 

/0 Display in octal radix 

/A Display in ASCII bytes 


When specified, the <address> argument is accepted in hexadecimal 
format unless some other radix has been set with the set default 
command. Optionally, <address> may be specified by immediately 
preceding the address argument with %D OR $%0, respectively. 
<Address> may also be one of the following: R@--Rll, AP, FP, SP, 
PC, PSL. 


3.7.7 Deposit Command 
Syntax: DEPOSIT [ <qualifiers> ] <address> <data> <CR> 


The command accepts data and writes it into the memory location 
Specified by <address> in the format described by the qualifiers. 
If no qualifiers are specified, the default qualifiers are 
implemented. The applicable qualifiers are identical to those of 
the examine command and described in Table 3-4. 


The <address> argument is accepted in hexadecimal format unless 
some other radix has been set with the set default command. 
Optionally, <address> may be specified as decimal or octal by 
immediately preceding <address> with %D or %0, respectively. 
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CHAPTER 4 
MICRODIAGNOSTIC DESCRIPTION 


4.1 MICRODIAGNOSTIC PROGRAM OVERVIEW 
The microdiagnostic programs provide module isolation for logic 
failures within the CPU, floating-point, and MDS memory 
controllers. All detected failures result in an error printout 
indicating the module, or smallest set of modules, to which the 
microdiagnostics can isolate the failure. 


The microdiagnostic package consists of two major test divisions: 
console adapter and hardcore, and microtests. Each test division 
is controlled by an associated monitor that provides 
non-diagnostic services to that division. 


a. Hardcore Monitor -- Console Adapter and Hardcore Program 
b. Microtest Monitor -- Microtest Program 


Both test division monitors are serviced by the console-resident 
microdiagnostic monitor. In addition to loading the hardcore and 
microtest monitors, the microdiagnostic monitor allows the 
operator test selection and execution options (Paragraph 4.6). In 
order to reduce the address space required to execute the hardcore 
and microtest programs, the common code of both programs has been 
incorporated into the microdiagnostic monitor. That code, which 
is unique to either the hardcore tests or microtests, has been 
incorporated into the associated monitors. 


The microdiagnostics reside on diskettes for the floppy drive. 
The basic test Sequence is: 1) hardcore tests, 2) microtests. 
The hardcore tests verify the operation of the minimum logic 
required to reliably execute the microtests. The minimum logic 
consists of the basic hardware elements required for data transfer 
and error reporting. 


The code, data, and structure required by the microdiagnostics 
prohibit them from being resident in the LSI-11 address space at 
any one time. The hardcore testS are executed out of a small 
buffer area in the LSI-1l11 memory. The microtests are executed out 
of the WCS of the VAX-11/78@ CPU. 


4.2 BASIC PROGRAM EXECUTION 

With the console program resident (in LSI-1l1l memory), the operator 
can execute the entire microdiagnostic package by issuing the test 
command. The console program overlays itself with the 
microdiagnostic monitor from the console floppy. (However, the 
floppy and terminal software drivers are not overlaid since they 
provide utility service to each of the monitors.) 


In turn, the microdiagnostic monitor transfers the hardcore 
monitor into the LSI-1l1 memory from the floppy. The hardcore 
tests are then executed sequentially out of the buffer in the 
LSI-1l1 memory. On completion of the hardcore tests, the hardcore 
monitor notifies the microdiagnostic monitor. The microdiagnostic 
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monitor, in turn, transfers the microtest monitor into the LSI-1l 
memory (from floppy). The microtest monitor then executes the 
microtests out of the WCS in approximately 1K microword overlays. 
On completion of the microtests, control is returned to the 
console program. 


Figure 4-1 illustrates program residency in the LSI-1l1 memory. 
Note that those items on a horizontal line are exclusive in 
memory; e.g., the console program or the microdiagnostic monitor 
may be resident, but not both. AS previously mentioned, the 
floppy and terminal drivers (and software bootstrap) are always 
resident. 


4.3 BASIC TEST STRATEGY 

The basic test strategy is to transfer data from a test source and 
load it into the logic element under test. The next step is to 
retrieve the data from that element and compare it with the 
original data loaded. Depending on the test requirements, logic 
element structure, and functional location, the retrieved data may 
or may not have a true compare. In either case, the fail/no fail 
decision is based on the expected results. In some tests, the 
same logic is tested uSing an array of data patterns. 
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TEST STREAM 
OVERLAYS 


MICRO-CODE 
BUFFER 


HARDCORE MICRO-TESTS 
MONITOR MONITOR 


WwCS MICRO- 
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Figure 4-1 LSI-11 Memory Program Residency 
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It 1S essential to the test strategy that the basic load and error 
reporting paths are initially tested for reliable operation. In 
an error-free situation, the microdiagnostic can notify the user 
when a test is completed. In the case of error detection, the 
microdiagnostic can identify for the user: the failed module and 
test, the data pattern used, and the expected test result. 


A simplified test procedure is illustrated in Figure 4-2. Note 
that a true compare is not necessarily the expected result. 
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Figure 4-2 Simplified Microdiagnostic Test Procedure 
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4.4 HARDCORE TEST DESCRIPTION 
The hardcore tests are the initial set of microdiagnostic tests 
executed. Paragraph 4.4.1 describes the hardcore test structure. 


The hardcore tests initially check the control and data registers 
of the Console Interface Board (CIB). This ensures test access to 
the VAX ID Bus. After the CIB tests, the clock board is tested. 
The clock is turned on and off, single-Stepped, and certain clock 
function status is retrieved over the Visibility Bus (V Bus). 


The next element tested is the microsequencer. For example, data 
is transferred onto the microstack and then retrieved. An address 
is placed on the microstack. The maintenance return feature is 
then used to pop the address off the microstack and load it into 
the micro PC. This allows the microaddress paths to be tested in 
small segments. 


As shown in Figure 4-3, the remainder of the hardcore test 
sequence tests WCS, PROM Control Store (PCS), and basic elements 
of the data path. Generally, these are address integrity and 
parity checking tests. The WCS is tested by writing a variety of 
address and data patterns to it, and checking for good parity, or 
forced bad parity. 


The basic elements of the data path are tested by writing data to 
certain registers, reading that data back, and comparing the 
results. The data path is tested for its ability to transmit and 
retain expected data. The basic capabilities of the Arithmetic 
Logic Unit (ALU) to transfer and compare data are tested. The 
scratch pads are also tested for retaining data; the scratch pads 
are used to hold error data in the case of error detection. 
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Figure 4-3 Hardcore Test Sequence 


4.4.1 Hardcore Test Structure 

Because of the limited LSI-ll memory address space, the hardcore 
tests are sequentially loaded from the floppy and executed out of 
a 1.5K byte buffer in the LSI-1l memory. The hardcore tests are 
implemented uSing special pseudo instructions. The pseudo 
instructions are actually functional statements, where each 
statement produces a table of parameters that resemble op codes 
and operand addresses. 


The hardcore monitor contains a software PC which, in effect, is a 
pointer into the tables. Based on the content of the op codes and 
operands, the monitor calls subroutines that are written in PDP-1ll 
code to perform the operation required by a specific test. 
Implementing test code in this manner allows a large test 
functionality to reside in a small address space. 
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4.4.2 Pseudo Instruction Description 

The following paragraphs describe the hardcore test pseudo 
instructions and their associated statement formats. Table 4-1 
defines the symbols and abbreviations used in describing the 
statement formats. 


Table 4-1 Instruction Symbol/Abbreviation Definitions 
Item Definition 


< > Used to denote a category name or argument within a 
functional statement, e.g., <SCR ADDRESS> represents a 
valid source address. 


[ ] Used to indicate that part of a functional statement 
that is optional, e.g., [<wCS ADDRESS’ INDEX)>], 
represents an address index value that may or may not be 
specified depending on the functional statement. 


’ Used to separate category names or arguments within a 
functional statement. 


SCR Abbreviation for Source. 
DST Abbreviation for destination. 
I,J,K Legal index names. 


Each pseudo instruction description is divided into two 
descriptive segments. The format segment describes the statement 
format using the symbols defined in Table 4-1. The instruction 
description is a brief paragraph describing general command 
operation and the available options. Each instruction description 
is preceded by the instruction mnemonic in boldface type. 


BLKMIC 


BLKMIC <SCR ADDRESS>, <SCR INDEX>, <WCS ADDRESS>, 
<WORD COUNT>, [<WCS ADDRESS INDEX)>] 


Move the <WORD COUNT> number of 96-bit microwords from the <SCR 
ADDRESS>, indexed by <SCR INDEX>, to the WCS starting at <WCS 
ADDRESS>, indexed by <WCS ADDRESS INDEX>. If an <SCR INDEX>D is 
ae ta the <SCR ADDRESS> is indexed by six PDP-1l words (i.e., 
96 bits). 


If the <WCS ADDRESS> starts with an alpha character, the <WCS 
ADDRESS> is used as a pointer to a table in the test data area of 
the test. Otherwise, it is used as a physical WCS address. 


For example, if the current value of the index is 2, 14 (<SCR 
INDEX> * 6) would be added to the <SCR ADDRESS> to find the first 
96-bit microword to load into the WCS. 
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CHKPNT 
CHKPNT [<PASS ADDRESS>], [<FAIL ADDRESS>] 


If the error flag, set during a compare instruction (see CMPXXX 
instructions), is zero, go to the <PASS ADDRESS>. If the error 
flag is not zero, go to the <FAIL ADDRESS>. If neither a pass nor 
a fail address is specified, go to the next instruction in line. 


The address of the next instruction is typed. These addresses 
appear on the typed line named TRACE (Figure 4-16). 


CLOCK 
CLOCK <TIMES> 


Step the system clock <TIMES> number of single time states. If 
<TIMES> is an integral number of four, single bus cycles are 
executed for each four <TIMES>. 


CMPCA 
CMPCA [<MODE>], <REGISTER>, <DST ADDRESS>, [<DST ADDRESS INDEX>] 


Compare the contents of the console register specified by 
<REGISTER> with the contents of the location specified by <DST 
ADDRESS>, indexed by <DST ADDRESS INDEX>. The <MODE> argument is 
generally EQUAL. If left blank, the default for <MODE> is EQUAL. 


If the comparison is false, set the error flag. If the <MODE> 
argument is not specified, it defaults to EQUAL. 


If the <REGISTER> argument is specified as IDREGLO or IDREGHI, the 
register used in the comparison is the ID Bus register that was 
read in the most recent READID instruction. 


CMPCAD 
CMPCAD [<MODE>], <REGISTER>, <DST ADDRESS>, [<DST ADDRESS INDEX>] 


Compare the contents of the console registers specified by 
<REGISTER> and <REGISTER>+2 with the contents of the location 
specified by <DST ADDRESS> and <DST ADDRESS>+2, indexed by <DST 
ADDRESS INDEX>. 


If the comparison is false, set the error flag. If the <MODE> 
argument is not specified, it defaults to EQUAL. 


If the <REGISTER> argument is specified as IDREGLO or IDREGHI, the 
register used in the comparison is the ID Bus register that was 
read in the most recent READID instruction. 
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CMPCAM 


CMPCAM [<MODE>], <REGISTER>, <MASK ADDRESS>, [<MASK ADDRESS 
INDEX>], <DST ADDRESS>, [<DST ADDRESS INDEX>] 


Take the content of the console register specified by <REGISTER>D, 
mask it with the content of the <MASK ADDRESS>, indexed by <MASK 
ADDRESS INDEX>, and compare it with the content of <DST ADDRESS>, 
indexed by <DST ADDRESS INDEX>. 


If the comparison is false, set the error flag. If the <MODE> 
argument is not specified, it defaults to EQUAL. 


If the <REGISTER> argument is specified as IDREGLO or IDREGHI, the 
register used in the comparison is the ID Bus register that was 
read in the most recent READIN instruction. 


The mask is performed by taking the content of <MASK ADDRESS>, 
indexed by <MASK ADDRESS INDEX>, complementing it, and 
bit-clearing the contents of <REGISTER> with it. 


CMPCMD 


CMPCMD [<MODE>], <REGISTER>, <MASK ADDRESS>, [<MASK ADDRESS 
INDEX>], <DST ADDRESS>, [<DST ADDRESS INDEX>] 


Take the content of the console registers specified by <REGISTER> 
and <REGISTER>+2, mask it with the contents of <MASK ADDRESS> and 
<MASK ADDRESS>+2, indexed by <MASK ADDRESS INDEX>, and compare it 
with the contents of <DST ADDRESS> and <DST ADDRESS>+2, indexed by 
<DST ADDRESS INDEX>. 


If the <MODE> argument is false, set the error flag. If the 
<MODE> argument is not specified, it defaults to EQUAL. 


If the <REGISTER> argument is specified as IDREGLO or IDREGHI, the 
register used in the comparison is the ID Bus register that was 
read in the most recent READIN instruction. 


The mask is performed by taking the content of <MASK ADDRESS> and 
<MASK ADDRESS>+2, indexed by <MASK ADDRESS INDEX>, complementing 
it, and bit-clearing the contents of <REGISTER> and <REGISTER>+2. 


CMPPCSV 
CMPPCSV <DST ADDRESS>, [<DST ADDRESS INDEX>] 
Compare the content of the PC Save register with the content of 


the location specified by <DST ADDRESS>, indexed by <DST ADDRESS 
INDEX>. If the contents are not equal, set the error flag. 
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ENDLOOP 
ENDLOOP <INDEX NAME> 


Add the increment value of <INDEX NAME> (see loop instruction) to 
the current value of the index specified by <INDEX NAME>. Compare 
the current value with the last value (specified in the loop 
instruction). If the current value is less than or equal to the 
last value, go to the instruction following the associated (I, J, 
or K) loop instruction. Otherwise, go to the next sequential 
instruction. 


ERRLOOP 
ERRLOOP 


Save the address of the next instruction. If an error is 
detected, and the loop or error flag is set (Paragraph 4.6), 
execution is restarted at this saved address after the IFERROR 
instruction is executed (Figure 4-11). 


FETCH 
FETCH <WCS ADDRESS>, [<WCS ADDRESS INDEX>], [<WCS ROM NOP>] 


If <WCS ADDRESS> is a numeric string, execute a maintenance return 
to the location specified by <WCS ADDRESS>, indexed by <WCS 
ADDRESS INDEX>. If <WCS ADDRESS> is an alphanumeric string, 
execute a maintenance return to the location specified by the 
content of <WCS ADDRESS>, indexed by <WCS ADDRESS INDEX>. If <ROM 
NOP> is specified, clear bit 7 of the Machine Control Register 
(MCR) during the maintenance return. 


FLTONE 
FLTONE <DST ADDRESS>, <INDEX NAME> 
Generate a 32-bit word of all zeros. Insert a logic one in the 
bit postion specified by the current value minus one of <INDEX 
NAME>, and load this word into the location specified by <DST 
ADDRESS> and <DST ADDRESS>+2. 

FLTZRO 


FLTZRO <DST ADDRESS>, <INDEX NAME> 


Generate a 32-bit word of all logic ones. Insert a zero in the 
bit position specified by the current value minus one of <INDEX 
NAME>, and load this word into the location specified by <DST 
ADDRESS> and <DST ADDRESS>+2. 
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IFERROR 
IFERROR [<MESSAGE NUMBER>], [<FAIL ADDRESS>] 
If the error flag is nonzero, type the PC of this instruction, the 
test number, subtest number, and the good and bad data. MThen, go 
to <FAIL ADDRESS> if the HALTD flag is not set (Paragraph 4.6). 


If the error flag is zero, or the <FAIL ADDRESS> is not specified, 
go to the next instruction. 


INITIALIZE 

INITIALIZE 
Set and clear the CPU initialize bit in the MCR, clear the single 
time state bit, set the single bus cycle bit, set the ROM NOP bit, 
and set the proceed bit in the MCR. 

KMXGEN 
KMXGEN <SRC ADDRESS>, <INDEX NAME> 
Generate the KMUX address specified by the current value minus one 
of <INDEX NAME> and load it into the KMUX field of the 
microinstruction specified by <SRC ADDRESS>. <SRC ADDRESS> points 
to a six word table in the test data section of the test that 
contains the microinstruction. 

LDIDREG 
LDIDREG <REGISTER>, <SRC ADDRESS>, [<SRC ADDRESS INDEX) ] 
Load the ID Bus register specified by <REGISTER> with the contents 
of the locations specified by <SCR ADDRESS> and <SCR ADDRESS>+2, 
indexed by <SRC ADDRESS INDEX>. 
If <REGISTER> is the microstack, microbreak, or WCS address, the 
content of <SCR ADDRESS> is taken to be 16 bits. Otherwise, it is 
taken to be 32 bits. 

LOADCA 
LOADCA <REGISTER>, <SRC ADDRESS>, [<SRC ADDRESS INDEX) ] 
Load the console register specified by <REGISTER> with the 


content of the location specified by <SRC ADDRESS>, indexed by 
<SRC ADDRESS INDEX>. This instruction loads 16 bits of data. 
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LOOP 


LOOP <INDEX NAME>, <START>, <END>, [<SIZE DEPENDENT> ] 


Initialize the loop parameter specified by <INDEX NAME> to the 
value specified by <START>. Save the value specified by <END> for 
the ENDLOOP instruction. Calculate and save the increment value 
for the ENDLOOP instruction with the following algorithm: 


If <START> is less than or equal to 
<END>, set the increment value to +1; 
otherwise, set it to -l. 


If <END> is an <INDEX NAME>, save the current value of that index 
name as the <END> value of this index name. 


If <SIZE DEPENDENT> is specified, and there is only one WCS module 
on the system, divide the larger of <START> and <END> by two. 
Otherwise, leave them unchanged. 


NOTE 
The tests are written for two WCS 
modules. This argument allows the loop 
parameters to be modified at run time if 
the system only has one module. 


MASK 
MASK <DST ADDRESS>, <MASK ADDRESS> 


Take the content of location <MASK ADDRESS>, complement it, and 
bit-clear the content of location <DST ADDRESS> with it. 


MOVE 
MOVE <SRC ADDRESS>, [<SRC ADDRESS INDEX>], <DST ADDRESS> 


Move the content of <SRC ADDRESS INDEX> (indexed by <SRC ADDRESS 
INDEX>) to the location specified by <DST ADDRESS>. 


NEWTST 


NEWTST <TEST NAME>, [<TEST DESCRIPTION>], [<LOGIC 
DESCRIPTION>], [<ERROR DESCRIPTION>], [<SYNC POINT 
DESCRIPTION> ] 


This instruction creates a test header document for the specified 


arguments. It clears the error flag and saves the PC of the next 
instruction for looping on test. 
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READID 
READID <REGISTER> 


Read the ID Bus register specified by <REGISTER> and load the 
content into locations IDREGLO and IDREGHI. 


RESET 
RESET 
Execute an LSI-11 reset instruction. 

REPORT 
REPORT <MODULE NAME STRING> 
Type out the module numbers of the modules specified by <MODULE 
NAME STRING>. If the HALTI flag is set, return to the 
microdiagnosStic monitor. 

SETPSW 
SETPSW <DATA> 


Load the LSI processor status word with the value specified by 
<DATA>. 


SETVEC 
SETVEC <VECTOR ADDRESS> 


Set the LSI-1l1 address specified by <VECTOR ADDRESS> to the 
expected trap routine. 


SKIP 
SKIP [<DST ADDRESS>] 
Go to the <DST ADDRESS>. If <DST ADDRESS> is not specified, go to 
the next test. If <DST ADDRESS> starts with the alpha character 
S, go to the next subtest. 
SUBTEST 
SUBTEST 


Increment the subtest counter. 
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TSTVB 
TSTVB <SRC TABLE ADDRESS>, [<SRC TABLE ADDRESS INDEX) ] 
Load and read the V Bus. Compare the contents of the data at <SRC 


TABLE ADDRESS>, indexed by <SRC TABLE ADDRESS INDEX>, with the V 
Bus data just read. The <SRC TABLE> has the following format: 


1$: .WORD <NUMBER OF BITS TO CHECK> 
VBUSG <CHANNEL NUMBER>, <BIT NUMBER>, <EXPECTED BIT 
VALUE> 
2$: WORD <NUMBER OF BITS TO CHECK> 
VBUSG <CHANNEL NUMBER>, <BIT NUMBER>, <EXPECTED BIT 
VALUE> 


VBUSG is a MACRO name that encodes the three arguments into one 
16-bit word as follows: 


BITS <@7: 80> = <CHANNEL NUMBER> 
BITS <14:88> = <BIT NUMBER) 
BIT <15> = <EXPECTED BIT VALUE> 


The following is an example of the <SRC TABLE ADDRESS INDEX>: 


TSTVB 15S,I1 

If the current value of the <SRC TABLE ADDRESS INDEX> is 2, 
and the <SRC TABLE> looks like the preceding table, the 
physical <SRC TABLE ADDRESS> would be 2S. 


TYPSIZE 


TYPSIZE 


Use the content of location BADDATA, which contains the value of 
the WCS data register when it was read, to determine the WCS 
module configuration, and type a message and the number of WCS 
modules that will be tested. If any of the following conditions 
exist, the test stream is aborted and the NER (No Error Report) 
flag is set. 


a. WCS module count iS zero 
b. bits 3--@ are nonzero 
Cs fifth K of WCS is not present 


These conditions mean that the WCS is either configured 
incorrectly or the WCS data register cannot be read correctly. 
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4.5 MICROTEST DESCRIPTION 

On completion of the hardcore tests, the microdiagnostic monitor 
overlays the hardcore monitor with the microtest monitor. 
Microtest sequencing and execution are then controlled by the 
microtest monitor. 


The microtest monitor begins to load the microtests from the 
floppy into the same buffer area used by the hardcore tests. 
However, in the case of microtests, this area is strictly a 
buffer. Since the microtests are implemented in system microcode, 
the tests are transferred from the buffer and loaded into and 
executed out of the WCS. 


The monitor references a table that contains the WCS addresses of 
the first instruction of every test in the overlay (Section) that 
waS just loaded in order to locate the address of the first test 
(first entry in the table). The address is loaded onto the 


microstack. A maintenance return is’ performed, popping the 
address from the microstack into the micro PC and initiating 
execution of the first test. At the end of each test, the 
microtest monitor is interrupted. This allows the monitor to 


check that the microtests are being executed in the correct order. 


The monitor then initiates the next test with another maintenance 
return. This sequence continues until the original 1K microword 
overlay has been executed. At this point, the microtest monitor 
loads another 1K microword overlay into WCS. 


Because of the microtest package size, more than one diskette is 
required for storage. When the monitor executes the last test on 
a diskette, it determines whether it is the last test of the 
entire package. In the case where it is the last test, the 
monitor prints out a message to the operator with instructions to 
load the next sequential diskette and enter a command to continue 
microtest execution (Paragraph 4.8). 


4.5.1 Microtest Structure 
The initial microtests complete the data path testing started by 
the hardcore tests. The microtests then begin to test the 


Translation Buffer (TB) and cache without using memory. The tests 
check the TB and cache for their ability to retain correct address 
and data information, and to check parity correctly. 


The Instruction Buffer (IB) tests are then executed, again without 
uSing memory. The IB test data is loaded into cache. The 
mMicrotests cause instruction test patterns to be retrieved from 
cache, and check the IB branching functions and controls for the 
data path. 


The interrupt and condition code logic is checked in a similar 


manner (i.e., test data loaded into and subsequently retrieved 
from cache.) 
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The next test segment covers the SBI control logic and its 
maintenance functions, and the memory system. After performing 
these tests, the microtests go back and test those functions of 
the TB, cache, and SBI subsystem that depend on retrieving data 
from memory (e.g., cache, SBI faults, etc.). A minimal amount of 
testing is performed on the Unibus and Massbus adapters. These 
tests force selected errors on the SBI and determine the adapters' 
capability to detect and react to the forced errors correctly. 


The floating-point accelerator is tested last. 


Figure 4-4 shows the microtest sequence. 
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Figure 4-4 Microtest Structure 
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On completion of the microtests, control is returned through the 
microdiagnostic monitor to the console program. The console 
reboots, sends the relevant bootstrap header information to the 
console terminal, and prompts for operator input. 


4.6 MICRODIAGNOSTIC MONITOR CONTROLS 

The following paragraphs describe the operator command execution 
control functions provided by the microdiagnostic monitor. Where 
appropriate, examples of command and program control flag usage 
are included. Also included is a description of microdiagnostic 
related error messages. 


The majority of the commands available in the microdiagnostic 
monitor are not used in the normal course of execution. Normally 
the operator enters the test command and executes the entire 
microdiagnostic package. The command mode is usually used 
following error detection. Following the error message printout, 
testing stops and control is returned to the monitor command mode. 
At this point, the operator executes those microdiagnostic 
commands he decides would be most helpful. 


Symbols used in the command syntax are the comma and < >. The 
comma is used to separate items within a list. < > denotes an 
argument, that is, either an address, pass count value, or a V Bus 
channel. Note that every command (or command line) must be 
terminated with a carriage return (CR). 


Control cC (*“C) is the user interrupt control character. If 
Control C is entered during test execution, the current test will 
complete, further testing is suspended, and control is returned to 
the monitor command mode. If Control C is entered while a test is 
looping on an error, the loop will be suspended and control 
returned to the command mode. Any command may be aborted if a 
Control C is entered in that command line. 


Table 4-2 describes the monitor commands. Note that although all 
commands, keywords, qualifiers, and flags are spelled out, they 
can be abbreviated to the first two characters. The only 
exceptions are the halt on error detection and halt on error 
isolation flags, which must be typed HD and HI, respectively. 
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Table 4-2 Microdiagnostic Command/Flag Descriptions 


Command/Flag 


DIAGNOSE 


Examples 


Description 


Initializes the program control flags, 
and starts microdiagnostic execution at 
test number one. 


Valid qualifiers are: 


/TEST: <NUMBER> -- Dispatch to the test 
number specified (do not execute any 
prior tests), and loop on the test 
indefinitely. 


/SECTION: <NUMBER> -- Dispatch to the 
section number specified (do not 
execute any prior sections), and loop 
on the section indefinitely. 


/PASS: <NUMBER> -- Execute the micro- 
diagnostics and the specified number of 
passes before returning to the console. 
If the number is -l, execute the micro- 
diagnostics indefinitely. 


/CONTINUE -- Used with the /TEST or 
/SECT switch to automatically continue 
after the specified test or section has 
been reached. 


/TEST: <N> <M> -- Dispatch to test <N>, 
execute tests <N> through <M> 
(inclusive), and return to command 
mode. 


/SECT: <N> <M> -- Dispatch to section 
<N>, execute sections <N> through <M> 
(inclusive), and return to command 
mode. 


NOTE 


preceding variations of the 


/TEST and /SECTION qualifiers, the value 
of <N> must be less than or equal to 
<M>. If <M> is less than <N>, testing 
will start at <N> and continue to the 
end. 


/TEST and /SECT cannot be specified 
simultaneously. 


DIAG/TEST: 2F 


Dispatch to test number 2F and execute 


it indefinitely. 
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Table 4-2 Microdiagnostic Command/Flag Descriptions (Cont) 


Command/Flag 


CONTINUE 


Set and Clear Flags 


SET/CLEAR FLAG 


SET/CLEAR FLAG 


SET/CLEAR FLAG 


SET/CLEAR FLAG 


SET/CLEAR FLAG 


SET/CLEAR FLAG 


CLEAR FLAG LS 


CLEAR LT FLAG 


SET/CLEAR FLAG 


SET/CLEAR SOMM 


SET/CLEAR SOMM: 


HD 


HI 


LOOP 


NER 


BELL 


ERABT 


ALL 


<ADDRESS> 


Description 


DIAG/SECT:B 
Dispatch to section 
execute it indefinitely. 


number B- and 


DIAG/PASS:--1 
Execute all of the microdiagnostics 
indefinitely. 


DIAG/TEST: 2F/CONT 
Dispatch to test 2F and start execution 
of the remaining tests. 


Continues microdiagnostic execution 
without changing the program control 


flags. 

Sets (or clears) the halt on error 
detection flag. 

Sets (or clears) the halt on error 
isolation flag. 

Sets (or clears) the loop on error 
flag. 

Sets (or clears) the no error report 
flag. 

Sets (or clears) the bell on error 
flag. 

Sets (or clears) the error abort flag. 
Clears the loop on special section 


flag. 
set.) 


(Note that this flag cannot be 


Clears the loop on special test flag. 
(Note that this flag cannot be set.) 


Sets 
flags. 


(or clears) all of the previous 


Sets (or clears) 
bit. 


the stop on micromatch 


Loads address into the CPU microsync 
register, and sets (or clears) the stop 
on micromatch bit. 
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Table 4-2 Microdiagnostic Command/Flag Descriptions (Cont) 


Command/Flag 


SET/CLEAR FPA: <ADDRESS> 


SET STEP STATE 


SET STEP BUS 


SET STEP INSTRUCTION 


SET CLOCK FAST 


SET CLOCK SLOW 


SET CLOCK NORMAL 


SET CLOCK EXTERNAL 


SHOW 


LOOP 


RETURN 


Description 


Loads <ADDRESS> into the FPA microsync 
register. 


Sets the CPU clock to single time 
State. 


Sets the CPU clock to single bus cycle. 


Both the SET STEP STATE and SET STEP 
BUS commands cause the monitor to enter 
step mode. Step mode types the current 
Clock state or the UPC value, and waits 
for terminal input. If a space is 
typed, the clock is triggered and the 
Current UPC value is typed out. If any 
other character is entered, step mode 
is exited. 


Sets the software single instruction 
flag and returns to the monitor. When 
the hardcore tests are invoked, the 
Current value of the Test PC (TPC) is 
typed. The monitor waits for terminal 
input. If a space is typed, the 
Current pseudo instruction is executed 
and the current value of the TPC is 
typed. If any other character is 
typed, step mode is exited. 


Sets the CPU clock speed to the fast 
margin. 


Sets the CPU clock speed to the slow 
margin. 


Sets the CPU clock speed to normal. 


Sets the CPU clock for an external 
oscillator. 


Causes a display of the HD, HI, LOOP, 
NER, BELL, ERABT, LS, and LT flags. 


Clears the HD and HI flags. Sets the 
LOOP and NER flags and executes a 
continue command. 


Returns control to the console program. 
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Table 4-2 


Command/Flag 


Examine 


EXAMINE 


EXAMINE 


EXAMINE 


EXAMINE 


EXAMINE 
EXAMINE 
EXAMINE 
EXAMINE 


EXAMINE 


EXAMINE 


EXAMINE 


EXAMINE 


Commands 


ID: <ADDRESS> 


VB US : <CHANNEL> 


RA: <ADDRESS > 


RC : <ADDRESS > 


LA 
LC 
DR 
QR 


SC 


FE 


VA 


PC 


Microdiagnostic Command/Flag Descriptions (Cont) 


Description 


The following examine commands cause 
the current microinstruction to be 
executed before the examine is 
performed, if it is the first examine 
Since entering the monitor command 
mode. All succesSive examines do not 
execute any additional 
microinstructions. ID Bus registers 
T1--T8 are destroyed during the 
examines, except for the V- Bus 
examines. All of the following 
examines, except V Bus, advance the 
clock to CPT@ before executing the 
command. 


Displays the content of the ID Bus 
register specified by <ADDRESS>. 


Displays the content of the V_ BUS 
channel specified by <CHANNEL>. Bit @ 
is at the right side of the display. 


Displays the content of the RA scratch 
pad specified by <ADDRESS>. 


Displays the content of the RC scratch 
pad specified by <ADDRESS>. 


Displays the content of the LA latch. 
Displays the content of the LC latch. 
Displays the content of the D register. 
Displays the content of the Q register. 


Displays the content of the _ SC 
register. 


Displays the content of the FE 
register. 


Displays the content of the VA 
register. 


Registers the content of the program 
counter. 
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Table 4-2 Microdiagnostic Command/Flag Descriptions (Cont) 
Command/Flag Description 


Deposit Commands The deposit command is the same as the 
examine command, except that the data 
to be deposited must be supplied by the 
user. 


DEPOSIT ID: <ADDRESS> <DATA> 
DEPOSIT RA: <ADDRESS> <DATA> 
DEPOSIT RC: <ADDRESS> <DATA> 
DEPOSIT LA: <DATA> 
DEPOSIT LC: <DATA> 
DEPOSIT DR: <DATA> 
DEPOSIT QR: <DATA> 
DEPOSIT SC: <DATA> 
DEPOSIT FE: <DATA> 
DEPOSIT VA: <DATA> 
DEPOSIT PC: <DATA> 


4.6.1 Monitor Control Examples 

The following paragraphs provide uSage examples of selected 
monitor controls. These descriptions are brief and are intended 
only to indicate some of the capabilities of the microdiagnostic 
monitor. 


4.6.1.1 HD/HI Flags -- In addition to testing, the 
microdiagnostics perform two basic functions: error detection and 
error isolation. Under normal circumstances, the user would set 
the HI flag. Setting the HI flag initiates the following 
microdiagnostic sequence: 


a. Error detection 
De Call isolation routine to identify the error cause 
Cc. Display an error message identifying the failed test, 


data pattern used, and the failing modules 
d. Terminate test execution. 


In a Situation where the user does not require a scope loop, and 
wants to halt execution at the error detection point, the HD flag 
is set. This flag halts the test before the microdiagnostic calls 
the isolation routine overlay (e.g., V BusS compare). 


4.6.1.2 Loop On Error Flag (LOOP) -- With this flag set, the 
microdiagnostic will revert to a tight program loop after error 
detection (assuming the NER flag is set). Note that the loop will 
continue even though the error is intermittent; the flag must be 
cleared to break the loop. 
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4.6.1.3 No Error Report Flag (NER) -- This flag suppresses the 
typing of error messages. The flag is especially useful in the 
case of looping on an error. Since the error printout takes time, 
the scope sync is lost during typing time. With error reports 
Suppressed, the loop is tight and produces a reasonable sync. 


4.6.1.4 Bell On Error Flag (BELL) 


Hardcore Tests -- When running the hardcore tests, setting this 
flag causes the console terminal to ring its bell when an error 
occurs. This flag is useful in a situation where a manual 
adjustment could clear the error. In this situation, the user 


would set the LOOP flag and the NER flag, producing a tight loop. 


However, with no error report, the user does not have an 
indication of where the error cleared during the adjustment. 
Setting the BELL flag is a compromise between a reasonably tight 
error loop (the BELL flag slows the loop Somewhat) and an error 
indication during the adjustment. If a scope were used during the 
adjustment, the user would have an error indication without losing 
the scope trace. 


Microtests -- In the microtests, one must loop on test 
(DI/TEST:n); then, after the error message has been printed, set 
the NER and BELL flags, clear the HI flag, and type CONTINUE. 


4.6.1.5 Continue Command (CONT) -- This command allows the user 
to proceed from a microdiagnostic halt situation. For example, 
Suppose that a hardware ECO, which has not been reflected in the 
diagnostic system, is incorporated into the computer. When the 
microdiagnostic halts following detection of the pseudo error, the 
user can bypass the failing test and continue execution at the 
next test by entering CONTINUE. 


4.6.1.6 Error Abort Flag (ERABT) -- This flag allows the user to 
display more than one error report in certain hardcore tests 
(tests which exercise a particular piece of logic with more than 
one data pattern). 


For example, consider the situation where the ERABT flag is set, 
and the test detects a type 2 error (ERROR2) on one of the initial 
data patterns. If the usSer were to enter CONTINUE, the flag would 
abort the remainder of the test and initiate execution of the next 
sequential test. However, with the flag cleared, CONTINUE will 
initiate execution of the same test with the next sequential data 
pattern. 


4.7 MICRODIAGNOSTIC RELATED ERROR MESSAGES 
The following paragraphs describe the microdiagnostic-related 
error message formats and their interpretation. All error 


messages are prefixed by a question mark to distinquish them from 
informational messages. 
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4.7.1 Syntax Error MessageS 

?USE DIAG COMMAND 

Execution of a continue command was attempted before a diagnose 
command. This would only occur if TEST/COM were used to invoke 
the microdiagnostics from the console program. 


?INVALID COMMAND 
The previously entered command was not recognized. 


? INVALID KEYWORD 
The argument of a command was not recognized. 


?NUMBER MUST BE HEX 
A non-hexadecimal number was recognized. 


4.7.2 System Error Messages 

2OPEN FILE: <NUMBER> 

An error was detected and identified while trying to open a floppy 
file. Error code is: 


<NUMBER> = 1 = Floppy hardware error 
<NUMBER> = 2 = File not found 
<NUMBER> = 3 = Floppy not ready 


?READ SECTOR: <NUMBER> 
An error was detected and identified while trying to read a sector 
from the floppy. Error code is: 


<NUMBER> = 4 = Sector number out of range 
<NUMBER> = 3 = Floppy queue full 
<NUMBER> = 1 = Floppy hardware error 


?KEYBOARD ERROR: <NUMBER> 
An error was detected and identified while trying to read the 
terminal. Error code is: 


<NUMBER> 
<NUMBER> 


5 
7 


Terminal driver busy 
Terminal hardware error 


?UNEXPECTED TRAP TO 4 PC = 
The LSI-11 trapped to 4 at the specified PC. 


4.7.3 Go Chain Monitor Error Messages 

?TIMEOUT IN TEST ... UPC = 

Indicates that the microcode is hung. The monitor did not receive 
a call from the microcode in the last four seconds. 


? EXECUTION OUT OF SEQUENCE UPC = SHOULD BE = 
The microcode has not executed the tests within the overlay in 
sequential order. 


?CLOCK STOPPED UNEXPECTEDLY 
The clock stopped and the SOMM bit was not set. 


? ILLEGAL MONITOR CALL: <NUMBER> 
The microcode made a call to the monitor with a bad argument, 
which was <NUMBER>. 4.93 


4.8 PROGRAM LISTING AND ERROR MESSAGE DESCRIPTIONS 

The following paragraphs describe microdiagnostic program listings 
and error message formats. It is beyond the scope of this chapter 
to describe the various diagnostic program assemblers and their 
associated languages. 


4.8.1 Monitor Listing Descriptions 

The program listings for the microdiagnostic-associated monitors 
(i.e., microdiagnostic, hardcore, and microtest) share the same 
listing format. That is, Since the three monitors operate out of 
the LSI-1l11, they are coded in MACRO-11 (PDP-11 assembly language) 
and are discussed aS one in the general description. 


Each listing is comprised of three general sections: Table of 
Contents, Program Definitions, and Program Code and Descriptions. 
Each page in a listing has a title containing the name of the 
program, the date the particular listing was generated, the page 
number, and a line item that indicates the content of that page 
(listing header) (Figure 4-5). 


The Table of Contents is a list of the content of the program 
listing. The first (left) column contains a hyphenated number. The 
number preceding the hyphen specifies the page number of the 
listing on which the line appears. The number following the hyphen 
is a listing line number. This number specifies the starting line 
(within the listing) of the associated listing content contained 
in the right column (e.g., definitions, utility routines, test 
sections, etc.) 


The Program Definition section specifies register address 
assignments, bit definitions, module and bus name assignments, and 
other constants that are used throughout the program. 


The remainder of the listing (and the largest section by far) is 
the Program Code and Description section (Figure 4-5). The format 
is described on a per column basis from left to right. Note that 
the address and data radix for all monitor listings is octal. 

* Column 1, Listing Line Number -- Each line in the listing 
is assigned a unique decimal number to allow easy 
referencing from the Table of Contents. 


Column 2, Address -- The address of the instruction. 


Column 3, Content of the Address listed in Column 2 -- 
This is usually an instruction (e.g., reference line 
number 79 in Figure 4-5). The address is 191928, and its 
content is 932767, which is the octal code for a Bit Test 
(BIT) instruction. 


Column 4 and 5 -- If the instruction is a two-word or 
three-word instruction, the second and third words are 
Specified in columns 4 and 5, respectively (e.g., 
reference line number 79 in Figure 4-5). This BIT 
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STAR MICRO YEST MONITOR MACRO Mia @3IeMAR@77 10302 PAGE 3 LISTING 
FLAG TEST ROUTINE PAGE 
HEADER 
bps eS8TTL FLAG TEST ROUTINE 
77 108776 o@5067 177130 FLGTST: CLR TIMER } INITIALIZE THE TIMEOUT TIMER 
78 181002 133 UPDATESWR FIRST 
[78 1e1e20 esa767 sages i77esq err weTALC) Sway CONTROL _C FLAG SET? bt ——— Text 
88 181026 00146 8EQ 113 } BRANCH JTF NO REFERENCE 
61 101030 @32767 geeacs 177054 BIT HLOOP,SWR } LOOP FLAG SET? 
82 101036 901463 BEQ 118 } BRANCH IF NO 
83 101840 984767 003146 JSR Pc, STOPCLK ) STOP THE CLOCK 
64 101044 GETUPC } GET THE CURRENT UPC 
85 101846 9012667 1772822 MOV (SP)+,STMPO y SAVE 
86 101052 CALLMICMON ' # GO TO THE MICRO MONITOR 
87 1601078 @32767 eae0ees 177014 BIT WLOOF,SWR } LOOP FLAG STILL SET? 
68 101076 ee1aal BNE 12S } BRANCH IF YES 
89 1011002 982737 eae20e 163¢32 B18 MCLRUWRO,@#CONMCR 7» GOING TO RESTORE MONITOR CALLS 
9@ 101196 LOADID wWERIAOR,WUSCAOR 7 LOAD THE ERROR 1 ADDRESS 
91 101124 LOAOIO WERICAT,#USCOAT # RESTORE THE JUMP ADDRESS 
92 101142 LOADIO WER2ADR,WUSCADR } LOAD THE ERROR 2 ADDRESS 
93 101160 LOADIO WERIDAT,MUSCOAT # RESTORE THE JUMP ADORESS 
94 101176 904767 9383036 JSR PC, MRETURN 00 MAINTENANCE RETURN ON ORIGINAL UPC 
95 {0led2 904767 @as0i4 $ R PC,RUNC ART JHE CLO 
96 101206 105737 163016 1183 TST8 @NTXRDY y MICROCODE CALL YET? 
97 101212 00402 BMI 108 } BRANCH IF NO 
98 101214 990167 aaedi2 IMP 2s SECOND 
99 101220 32737 aeee4a 163032 1a83 BIT #CLKSTPO,@®CONMCR 3 DID THE STAR CLOCK STOP? TEXT 
100 101226 ge1116 BNE 3s } BRANCH IF YES REFERENCE 
191 101230 932767 eaaqees 176654 BIT HLOOP, SHR }) LOOP FLAG SET? 
192 101236 901257 BNE FLGTST } BRANCH IF YES 
103 101242 905267 176666 INC TIMER p INCREMENT THE TIMEOUT TIMER 
bie 101244 971256 BNE 18 } BRANCH IF NO TIMEOUT YET 
1a 
136 }¢ 
107 ) THIS CODE INOICATES THAT THE MICROCODE HAS BLOWN UP 
148 Je 
109 
118 101246 TYPE WSCALF ; 
111 101262 TYPE 4MSG2 } TYPE TIMEOUT ERROR MESSAGE 
112 101272 @26767 177314 176546 CMP TSTSAVE,STSTNM Ff IN THE FIRST TEST YET? 
113 101308 @eiai4 BNE 58 ) BRANCH IF YES 
114 101302 916767 177304 176564 MOV TSTSAVE,STMPQ 
115 181310 905267 17656¢ INC STMPO 
116 101314 TYPES  M#STNPO,HEX 
117 101338 ae0406 BR 5s 
116 101332 583 TYPES  #STSTNM,HEX } TYPE THE TEST NUMBER 
119 101346 683 TYPE #SIXSPC ) TYPE SIX SPACES 
120 101360 TYPE #HSG3 ) TYPE “UPCa" 
121 101372 94767 @n2614 JSR PC, STOPCLK » STOP THE STAR CLOCK 
122 101376 8st LoaOVBUS 
125 101400 GETUPC ) READ THE UPC SAVE REGISTER 
124 101402 012667 176466 MOV (SP)+,STMPO } SAVE IT 
125 101426 | TYPES | SSTHPO,HEX } TYPE THE CURRENT UPC 
| 126) 101422 | | type ' w#scrir [3 
127! 101434 CALLMICMON y GO TO THE MICRO MONITOR | 
128 101452 | 162767 | eaeaes | 176372) | suB | “4, TSTPTR 1 RESTART AT THE CURRENT TEST 
| 129] 101460 ' aaes67 | 177262 gmp REST iY auras | 
130 ‘ { i ‘ | 
\,! | | | | | 
oe | | | | | | | | 
LISTING 
LINE ADDRESS INSTRUCTION 
NUMBER CONTENT MNEMONIC COMMENTS 
ADDRESS SECOND AND LABEL OPERAND 
THIRD WORDS DEFINITIONS 
OF INSTRUCTION 
TK-0773 
Figure 4-5 Monitor Listing 


Sample 
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instruction happens to be a three-word instruction, the 
second word is 640000, and the third word is 177064. 
Thus, this instruction is testing bit 14 (848800) to 
determine if the Control C flag is set at address 1779064. 
(Note that this flag was defined in the definition 
section.) 


Column 6, Label -- This symbol is the name used by the 
program mnemonics to reference this instruction (e.g., 
reference line number 95 in Figure 4-5). The label in 
this case is 12$. 


Column 7, Instruction Mnemonic -- This is the assembler 
language mnemonic for the instruction (e.g., Bit Test 
Instruction = BIT). 


Column 8, Operand Definitions -- These symbols and 
mnemonics are the assembler language mnemonic definitions 
for the operands. 


Column 9, Comments -- A brief description (following the 
semicolon) of the instruction operation. 


4.8.2 Hardcore Listing Description 

The general format of the hardcore listing is similar to that of 
the monitors (i.e., Table of Contents, Program Definitions, and 
Program Code and Descriptions). The left column of the Table of 
Contents contains a hyphenated number. The number preceding the 
hyphen specifies the page number of the listing on which the line 
appears. The number following the hyphen is the listing line 
number, indicating the starting line of the associated listing 
contents. The definition Section is similar to the monitor 
listings, i.e., address, module and bus aSsSignments, bit 
definitions, and other constants used in the program. 


The remainder of the listing is the Program Code and Descriptions. 
As indicated in the Table of Contents, the hardcore tests are 
composed of sections and tests. The section number represents a 
1.5K byte segment. The section number is displayed on the console 
terminal during hardcore test execution. The test number 
identifies a test on a particular logic area or function. The 
subtest number (which is not referenced in the Table of Contents) 
identifies a particular portion of a test. For example, Subtest 1 
floats a logic one through each bit of a register; Subtest 2 
floats a logic zero through the same register. 


As shown in Figure 4-6, the program code is preceded by an 
outlined test header area. A Subtitle statement (.SBTTL) generates 
the test number and title above the header area. 


The header area consists of five descriptive segments. The first 
line within the outlined header repeats the test number and test 
title. The test description segment is a brief paragraph 
describing the general logic area tested and method of test. The 
logic description segment describes the test in more detail. 
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MICRO OITAGNOSTIC HARDCORE TEST 
CS BUS DATA INTEGRITY 


Tic 
2538 


TEST 
HEADER 
AREA 


2534 
e535 
2536 


2537 
2538 
2539 
254a 
25u1 
2542 
2543 
2544 
2545 
2546 
2547 
2548 
2549 

| 255al 
2551 

25Sal 


LISTING 
LINE 
NUMBER 


™ 


SBTTL 
e 
PP RRARAAARAARAEKAAKAEAHARARARERHEAKARANAAKAKRAERARKARAARAARRARAREARKAARRRARAK 


$+ 


+ 


sTEST 
’ 


3 
’ 
3 
3 
’ 
3 
’ 
, 
’ 
’ 
3 
’ 
3 
’ 
, 
, 
’ 
’ 
3 
’ 
3 
3 
3 
’ 
’ 
’ 
3 
3 


MACRO MiB 2GeAPRo77 10237 PAGE 29 


SUBTITLE 


ae STATEMENT 


Tic CS BUS DATA INTEGRITY 


ic CS BUS DATA INTEGRITY 


TEST DESCRIPTION 


THIS TEST CHECKS THE DATA INTEGRITY OF THE CS BUS BY FLOATING 
A ONE AND A ZERO THRU A MICRO WORD, EXECUTING THE MICRO 
WORD, AND CHECKING THE V BUS FOR PARITY ERRORS, 


SUBTST { © FLOAT A ZERO THRU THE CS BUS 
SUBTST 2 © FLOAT A ONE THRU THE CS BUS 


DESCRIPTION 

THIS TEST CHECKS THE ID RUS INTERFACE TO THE WCS MODULES, THE 
DATA INTEGRITY OF THE WCS MEMORY CHIPS AND THE DATA INTEGRITY OF 
THE CONTROL STORE (CS) BUS, 


MESCRIPTION 
DATAs EXPECTED V BUS CHANNEL, BIT AND VALUE 
RECEIVED V BUS CHANNEL, BIT AND VALUE 
LOOP COUNT = INDICATES WHICH BIT IN THE 32 BIT GROUP IS UNDER 
TEST, ITeEo 18B8IT 8, 2RBIT 1, SEBIT 2, ETC. 
LOOP COUNT = INDICATES WHICH 32 BIT GROUP IS UNDER 
TEST, TE, 18 BITS<3186>, A2BBITS<63832>, 3BBITS<95236U> 


NOTES THE EXPECTED AND RECEIVED V BUS CHANNEL INDICATES WHICH 32 BIT 
GROUP HAS BAD PARITY IN IT, I,E£. 102XeBITS<31200>, 
1O1X3BITS<63232>, AND 1G0X#BITS<9S364>, 


SYNC POINT DESCRIPTION 


PRBS eee Se RRR R ERE SEER RAR ORAL SALE RASS ARE ARES ESR SE RSE ER ESE ERAS SSSR SSE 


SUBTST 1 = SYNCUC@eTEST PATTERN IS ACTIVE ON THE CS BUS 
SURTST 2 = SYNCUD@=@TEST PATTERN IS ACTIVE ON THE C$ AUS 


ABASS@ TiC 
agassy4 INTTTALIZE 
80aSs6 SUBTEST 
PAPSILITTTLLTTLLALAL IAD LLTATTAATATA TTA 
aaasse TICSis 
9+ 
: FIRST FLOAT A ZERO THRII THE CS BUS 
je 
808560 LOOP «J, 1,3 s LOOP COUNT FOR THE 3 BANKS 
88a570 LOIDREG USCADR,TMP190 4 SELECT LOCATION ZERO 
880576 LOOP —s Ky 1,3 y INITIALIZE THE CONTENTS OF LOCATION @ 
AGA626 LDTOREG USCDAT,TMP1C2 9 wee 
QBAB614 ENDLOOP K ¥ eee 
Ban620 Loop =—s_- I, 1,32 s LOOP COUNT FOR THE BIT$ IN A BANK 
880630 LOIOREG USCADR, TMP100,J 3 LOAD THF BANK ANDRESS 
280636 FLTZRO | THPIOLyI » GENERATE THE TEST PATTERN 
aaroug | ERLOOP | | 
204646 LDIDOREG, USCDAT,TMP1@1 3 LOAD INTO THE SELECTED BANK 
Pagesu ;  FetcH [e000 |} EXECUTE THE MICRO WORD | 
| | | | 
ADDRESS ADDRESS INSTRUCTION COMMENTS 
CONTENT OPERANDS 
TK-0769 
Figure 4-6 Hardcore Listing Sample 
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The error description segment specifies test parameters. For 
example, in the error description of Figure 4-6, the first line 
specifies what is expected during the test; the second line 
specifies what is received. The third line indicates which bit in 
the 32-bit array is under test; the fourth line indicates the 
32-bit group under test. The sync point segment specifies critical 
points in the listing around which an error loop or scope loop 
might be set up (Paragraph 4.9.2). 


Following the test header is the program code. The hardcore 
listings are described on a per column basis below. 

. Column 1, Listing Line Number -- Each line is assigned a 
unique decimal number to allow easy referencing. 


Column 2, Address -- The relative address (PC) of the 
instruction. 


Column 3, Address Content -- Content of the address 
listed in Column 2. (Note that the contents are the 
pseudo instructions described in Paragraph 4.4.2.) 


Columns 4 and 5, Instruction Operands -- The operands are 
the instruction Source, destination, or index values. The 
mnemonics appearing in these columns have been defined in 
the definition section of the listing. 


Column 6, Comments -- A brief descriptive note concerning 
the instruction operation. 


4.8.3 Microtest Listing Description 

The general format of the microtest listing is somewhat similar to 
the other microdiagnostic listings, i.e., a Table of Contents, 
Program Definitions, and Program Code and Descriptions. However, 
Since the microtests are executed out of the WCS, they are written 
in system microcode and, therefore, are Similar to the system 
firmware listings. Unlike the hardcore listings that are assembled 
in one listing, the microtests are assembled into separate 
listings by 1K microword test sections and identified by those 
section numbers. Note also that the address and data radix for 
these listings is hexadecimal. 


The Table of Contents iS Similar to those of the other listings; 
1.e., it contains a line number entry and the corresponding 
listing content description. Since the first column does not 
contain assembler directives, only the line number appears. The 
Program Definition section describes all macro definitions 
associated with the listing. 


The Program Code and Description section format is Similar to that 
of the system firmware listing. As in the hardcore listing, the 
program code is identical to the hardcore format and content 
described in Paragraph 4.8.2. 
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The microtest listing is described on a per column basis (Figure 
4-7) e 
* Column 1, UPC -- This column specifies the address 
contained in the UPC at that particular microstate. 


Column 2, Microword -- This column describes’ the 
microword content of the address specified in column l. 


Column 3, Listing Line Number -- Decimal number assigned 
to allow easy referencing. 


Column 4, Microstate Operation -- This column specifies 
the operation during a particular microstate. The 
notations used to describe the operation have been 
defined in the program definition section. 


Column 5, Comments -- A brief descriptive note concerning 
the microstate operation. (A detailed firmware 
description is provided in the VAX-11/78@8@ Central 
Processor Technical DeScription, e.g., field definitions, 


coding conventions, etc.) 


4.8.4 Microdiagnostic Execution 

The entire microdiagnostic package may be executed by entering 
TEST on the console terminal. Other operation options are 
described in the detailed diagnostic operating procedures in The 
VAX-11/788 Diagnostic System User's Guide (EK-DS78@-UG-@01). 
Following microdiagnostic identification the monitors initiate 
hardcore and microtest execution. Figure 4-8 illustrates typical 
console terminal output during error-free microdiagnostic 
execution. 


The microtests and hardcore tests are numbered sequentially (with 
no duplication of test numbers). As shown in Figure 4-8, there is 
no differentiation between hardcore and microtests. A 
differentiation is required only in the case of an error 
(Paragraph 4.8.5). 


The monitor loads the test, and the test section number is printed 
on the console terminal. Test execution is then initiated. The 
section number is printed (in hexadecimal) prior to execution to 
allow the operator to identify the exact failing section in the 
case of an error. 


The entire microdiagnostic package requires two diskettes. As 
indicated in Figure 4-8, the microdiagnostic monitor instructs the 
Operator when to mount the second diskette, and prompts for the 
command required to initiate execution of those diagnostics. 


4.8.5 Error Message Format 


The general error message format for both types of 
microdiagnostics is shown in Figure 4-9. 
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1 DWMOGA.MCR(400,3262) 12815 21°APRe1977 MICRO 31(241) Microcode file Page 7 


s DWMOGA.MIC(400,3262) 14335 20@APRi977 TEST AS CES REGISTER ALU N BIT 
: 1832 ,PAGE "TEST AS CES REGISTER ALU N BIT" 
| 1833 POSSE OSORESRSSSSSSSHSSESSSSHSEHHSSHESSHSSESSSESSHHSHEHESSHRSSHEGEHEEE EEE HG 
2 1834 344 
: 1035 9 TEST AS CES REGISTER ALU N BIT 
3 1836 3 
: 1837 3» TEST DESCRIPTION 
11838 3 THIS TEST CHECKS THE ALU N BIT IN THE CES REGISTER. THIS Ig DONE 
2 1839 3 BY SELECTING THE ALU TO DO A+B AND AeB, AND FaB, WITH SPECIFIC 
TEST 3 1840 3 DATA PATTERNS ON THE AMX AND BMX TO CHECK THE LOGIC THAT GENERATES 
HEADER 1041 3 THIS BIT, 
1 1842 3 
ARED , ' SUBTST 1 © CHECK THE DATA PATTERNS THAT REQUIRE THE ALU TO 
3 BE EXECUTING AN A*B TO GET THE CORRECT ALU DATA. 


SUBTST 2 © CHECK THE DATA PATTERNS THAT REQUIRE THE ALU TO 


1846 3 BE EXECUTING AN A@B TO GET THE CORRECT ALU DATA, 
1847 3 SUBTST 3 © CHECK THE DATA PATTERNS THAT REQUIRE THE ALU TO 

1848 3 BE EXECUTING ANYTHIN BUT AN AB OR A&B, 

1849 3 

1850 3 LOGIC DESCRIPTION 

18513 THIS TEST CHECKS THE LOGIC NETWORK ON THE CEH MODULE THAT GENERATES 
1852 3 THE ALU N BIT, AND THE MULTIPLEXOR ON THE ICL MODULE THAT FEEDS 
1853 3 THE ALU N BIT IN THE CES REGISTER, 

1854 3 

1855 3 ERROR DESCRIPTION 

1856 3 DATA’ EXPECTED CES REGISTER 

1887 3 RECEIVED CES REGISTER 

1856 3 LOOp COUNT ~ INDICATES WHICH DATA PATTERN IS BEING USED, 
1859 3 (SEE THE DATA AT THE END OF THE TEST) 

1860 3 

1861 3» SYNC POINT DESCRIPTION 

1862 3 SUBTST 1 © SYNCLAS°"ALU N BIT GETS LOADED 

1863 3 SUBTST 2 = SYNC{B=ceALU N BIT GETS LOADED 

1864 3 SUBTST 3 © SYNCiCeeaLy N BIT GETS LOADED 

1865 see 


’ 

3 

3 

3 

3 

3 

3 

i 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

’ 

3 

$ (866 POOH EHH RAHA HESEREOREREEHESHESEEEEEEEEEEEHETEESOTEREEHEREEEHEHEEESE EEE SD 
9 1867 80 
i 
3 
3 
3 
3 
3 
3 
3 
3 
3 
5 
3 
’ 
3 
3 
3 
H 
3 
3 
’ 
3 


U 14145 0018,0039,0D08G,09F8,0000-10F1 1868 ICLTS: NEWTST(,3) 
U 1015, 0018,0038,6580,0A80,0000,1018 1869 R(OJK6,18) ) ADDRESS OF AMX DATA 
U 1018+ 100000030,0180208007000001135 1879 %9 CALL, J/UNJAM y CLEAR ANY SBI INTERRUPTS 
U 1019, 0018,0038,7580,0A88,0000,1140 1871 R(1).K(,20) } ADDRESS OF BMX DATA 
U 14405 60198 6003877980,0A9G,000001141 (872 R(2).KE,30) y ADDRESS OF EXPECTED ALU N BIT 
U 1141, 0818,0038,4180,0800,0000,1142 1873 DoK{ 280) 
U 1142+ 01000003C»0189+08000000001143 1874 DoD, LEFT? y GENERATE MASK FOR N BIT 
U 1143, 0001,003C,0180,0A98,0000,1144 1875 R(3).0 ) SAVE 
1876 
1 OOOO OOO 
1878 34 
4879 3 DO THOSE FUNCTIONS REQUIRING THE ALU TO DO AN A PLUS B 
1880 je 
1864 
U 11445 0018,0038,D580,09F0,0000,101A 1882 T8Sit RCCOC).KE,6) ) SET THE LOP COUNT 
U 101A, 0000,003D,0180,0800,0000,3124 1883 20 SUBTEST 
U 101B, 0000,003C,0180,0A00,020001145 1884 ICLTSLisSVA.RCQ) 
| u 1145,] 0000,803C,0180,C800,0000,1146 1885 | D(BYTE)CACHE,P | § FETCH AMX DATA | 
U 1146, 0001,803C,0180,GAA8,0000,1147 | 1886 R($).D 9 SAVE 
[ 1147,) 0000, 003C ,0180,0A08, 0200, 1148 1687 VALR C1) | | 
U 11486) 200A, 803C,0180,C8OG,0000,1149 | 1898 | D(BYTE)..CACHE,P ) FETCH BMX DATA 
| | | | | | 
MICRO MICROWORD LINE MICROSTATE COMMENTS 
PROGRAM CONTENT NUMBER OPERATION 
COUNTER 
(UPC) 


TK-0771 


Figure 4-7 Microtest Listing 
Sample 
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oe TEST 


MICRO [TIAGNOSTIC V.05S 
01902703,» 


NO. OF WCS MODULES = 0001 FIRST 
04905706207708 709 20Ar OB, OC x ODvOEr OF s10v1livi2v13v149i1Seldsi7» 
me 


189197 1Ar1Bs1CyiDy ty 1F y 209219227239 247257267277 289297 Ar 2By 2Cy 2M PEAT 
OF 9309319329339 349 357 369377 387397 BAr REFERENCE 
END FASS 000001 
SECOND 
MOUNT FLOFPY #2 & TYPE ‘nr'| TEXT 
MICeDI REFERENCE 
SE» 
# MEM CTRLS= 00000001 
3Cy» 3» 
4K CHIF OOOOOEOS OPERATOR 


SE SF» 
. INPUT 
CFU TR= 00000010 UNDERLINED 


407417427437 4494574627477482497 4A? 
CTRL 1 MAX ADR+1= 00080000 

4B,» 

CTRL 1 MAX ADR+1= 00080000 

AC + Alls 

ENT FASS 000001 
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Figure 4-8 Typical Error-Free Terminal Output 


ERROR: <PC> TEST: <#> SUBTEST: <#> 


DATA: XXXXXXXX 
XXXXXXXX 


XXXXXXXX 
TRACE: W.X.Y.Z 
FAILING MODULES: (M8269 (S13)... 
NOTE: 


PC IS OCTAL FOR HARDCORE TESTS, 
OTHERWISE ALL NUMBERS ARE HEX. 
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Figure 4-9 Error Message Format 
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The first line items are ERROR, TEST, and SUBTEST. ERROR is the 
address (PC) of the failing test. In the case of a hardcore test 
error, the PC is displayed as a Six-digit octal address, since 
these tests are executed out of the LSI-ll. In the case of a 
microtest error, the PC is displayed as a four-digit hexadecimal 
address Since it executes out of WCS. 


TEST is the failing test number. Note that this is different from 
the section number sent to the console terminal during error-free 
execution. SUBTEST is the failing subtest number. These _ three 
first line items are important in referencing the program listings 
(Paragraph 4.9.2). 


The DATA line item represents data used during the particular 
test. The number of data words displayed depends on the particular 
test. Generally, in the hardcore testS two words are displayed; 
the first word is the expected (or good) data, the second word is 
the received (or bad) data. However, as described in Paragraphs 
4.8.2 and 4.8.3, the program listings contain a header describing 
the data patterns used. 


The TRACE line item is involved in the fault isolation procedure 
in determining the set of modules responsible for the failure. 


The last line item is FAILING MODULES. The output of this item 
represents the failing module and its backplane slot number. In 
some cases, the output will be several module numbers listed in 
the order of failure probability. However, in other cases the 
output will not be a module number. For example, consider the 
Situation of a grounded ID Bus bit. The failure could appear to 
extend across all boards on the bus. Rather than printing out all 
related module numbers, the program would print out ID BUS. 


4.9 LISTING/ERROR MESSAGE CORRELATION 

This subsection provides basic direction in the use of error 
message content and its relationship to the program listings. The 
examples are included mainly to illustrate basic microdiagnostic 
capabilities. 


4.9.1 No Error Message Situation 

Consider the situation where the operator has’ initiated 
microdiagnostic execution using the TEST command. For one reason 
or another execution stops in the hardcore tests, and an error 
message is not printed. As shown in Figure 4-18, execution stops 
on test section @4. 


The operator haS a reasonable index into the hardcore test 
listings since section @4 is one of the initial sections executed. 
Referencing the section number in the hardcore listing Table of 
Contents, the operator finds that the section 94 description 
starts on listing line number 777. 
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CONSOLE TERMINAL OUTPUT 


re TEST 


MICRO DIAGNOSTIC V.05 


01902703» 


63; OF WCS MODULES = 0001 
9 


TEST 
NUMBER 
INDEX 


le ) 
le ) 
1e bs) 
ie 5 
{eo 5 
le 6 
2= 42 
3e 141 
Ye 296 
Ge 206 
Se 264 


13-1a7A 
13013870 
t4e{162 
1$e1282 
15°1282 
1501367 
1601394 
1601599 
17°1535 
1721656 
1801677 
1901745 
2001771 
2101817 
2191817 
22019%6 
2301976 
24-2061 
2402061 
25"2158 
2602327 
26%2327 
27-2372 
28e242u 
2922530 
38-2621 
30-2621 
3122748 
31°2807 
3202845 
33-2959 
3403960 
3403060 
35-3168 
3623229 
3623229 
3723365 


MICRO DIAGNOSTIC HARDCORE TEST MACRO MIA 
TABLE OF CONTENTS 


LISTING TABLE OF CONTENTS 


28eAPRe77 18237 


CMPCA ANDO CMPCAM MONDE DEFINITIONS 
SWITCH REGISTER BIT DEFINITIONS 


CONSOLE 


ADAPTER REGISTER DEFINITIONS 


ID BUS REGISTER DEFINITIONS 
MODULE AND BUS NAME ASSIGNMENTS 


SECTION NUMBER @1 
TAY CONSOLE ADAPTER REGISTER RESPONSE 
702 CONSOLE "TO 10" REGISTER DATA INTEGRITY 
SECTION NUMBER Be 
793 CONSOLE "MCR" REGISTER DATA INTEGRITY 
Tou CONSOLE "IDCS" REGISTER DATA INTEGRITY 
705 CONSOLE RXDNE AND TXRDY REG DATA INTEGRITY 
706 TXREADY AND RXNONE INTERRUPTS 
SECTION NUMBER @3 
TA? TO BUS DATA LINES DATA INTEGRITY 
TA8 V_ BUS SELF TEST PROGRAM 
ECTION NUMBER O4 5 LISTING 
Tag CONSOLE CLOCK CONTROL INDEX 
TOA CONSOLE IO CYCLE FUNCTION 
TAB CONSL FROM ID REG CLK CTRL & DATA INTEG 
SECTION NUMBER @5 
TAC CONSOLE MAINTENANCE RETURN 
TAD RXCS REGISTER FROM THE ID BUS SIDE 
SECTION NUMBER @6 
TOE TXCS REGISTER ON THE ID BUS 
SECTION NUMBER 97 
TOF 10 BUS REGISTER ADDRESS INTEGRITY 
SECTNO NUMBER @8 
T1@ CI8 INITIALIZE FUNCTION 
SECTION NUMBER AQ 
T11 CONSOLE REGISTER DUAL ADDRESSING 
Tie WCS DATA REGISTER READ 
Tt3 INITIALIZE THE CONTROL STORE 
SECTION NUMBER QA 
T14 WCS ADDRESS REGISTER DATA INTEGRITY 
T15 WCS ADDRESS REGISTER COUNT LOGIC 
T16 MICRO STACK DATA INTEGRITY 
SECTION NUMBER @B 
T17 MICRO STACK DUAL ADDRESSING 
T18 MAINTENANCE RETURN DATA INTEGRITY 
SECTION NUMBER @C 
T19 MAINTENANCE PETURN MICRO STACK INCREMENT 
TIA MICRO STACK WRITE OISABLE 
T18 WCS PARITY GENERATOR 
TiC CS BUS DATA INTEGRITY 
SECTION NUMBER 80 
T1D PCS PARITY CHECKERS 
TIE wOS DUAL ADNRESSING 
SECTION NUMBER GE 
TIF WCS OYNAMIC MEMORY TEST 
728 UBEN FIELD DECODE 
SECTION NUMBER @F 
Tei USUB FIELD "CALL FUNCTION*® 
T2e2 USUB FIELD "“RETURN® 
SECTION NUMBER 18 
T23 USUB FIELD “SELECT SPECIFIER* 
Tea UJMP FIELD DATA INTEGRITY 
TK-0770 


Figure 4-19 Listing Indexing Example 
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4.9.2 Hardcore Loop and Single Step Setup 

During microdiagnostic execution the error message shown in Figure 
4-11 is displayed on the console terminal. Since the error PC is a 
six-digit number (80909670), it is an octal address and indicates a 
hardcore test. Referencing TEST: 1C in the hardcore Table of 
Contents indicates that the test begins on line 253@. Referencing 
the error PC of 8898670 in the program code shows the PC to be at 
an IFERROR statement on line 2554. 


The function of the IFERROR statement (Paragraph 4.4.2) is to 
produce an error report if a failure is encountered in the test. 
Usually the IFERROR statement is preceded by a check or compare 
function (in this case TSTVB). Basically this test is comparing V 
Bus signals. In this example, the received data did not match the 
expected data; consequently, an error was detected. 


Since the hardcore tests execute out of the LSI-1ll, a scope loop 
may be too slow to be of practical use. An alternative is to use 
the set step instruction and loop commands of the microdiagnostic 
monitor. As indicated in Figure 4-ll, the operator sets the Single 
instruction and loop flags. In this case the loop range is between 
the statement following the previous ERLOOP statement (line 2551) 
and the IFERROR statement (line 2554). As shown in Figure 4-11, 
each time the operator types SPACE, the current PC is displayed. 
At TPC = 809662 the operator reaches sync point SYNC4C, at which 
time the operator could scope the CS Bus data bits in an attempt 
to detect the failing bit. (At this point in the test the 
microword has just been fetched from WCS and is driving the CS 
Bus.) 


The operator can exit from the step mode by typing any character 
except SPACE. In the example, Control C has been typed and control 
returned to the microdiagnostic monitor command mode. 


4.9.3 Microtest Scope Loop Setup 

During microdiagnostic execution the error message Shown in Figure 
4-12 is sent to the console terminal. Note that execution stopped 
on test section 3A. 


Since the error PC iS a four-digit number (1@1E), it iS a 
hexadecimal address and indicates a microtest. USing the test 
section number of 3A, and referencing the Table of Contents for 
that section, test A5 starts on line 1832. A look at the PC column 
(of the microtest listing) shows that the error PC is on line 
1986. 


By scanning back through the microcode, select a sync point, in 
this case SYNCI1A on line 19@1. Control is returned to the 
microdiagnostic monitor via Control C. The operator enters a CLEAR 
SOMM: <1153> command. This command will clear the stop on 
micromatch bit, and produce a sync pulse when the UPC equals the 
content of the microbreak register (1.e., 1153). The operator then 
enters a loop command. This sequence causes the test to begin 
looping and produce a sync pulse each time the UPC = 1153. 
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CONSOLE TERMINAL OUTPUT LISTING TABLE OF CONTENTS HARDCORE PROGRAM LISTING PAGE # 


MICRO DIAGNOSTIC HARDCORE TEST MACRO 1A 28eAPRe77 [8937 MICRO DIAGNOSTIC HARDCORE TEST MACRO MIG 2GeAPRe77 10337 PAGE 29 


>> TEST 


ERROR 
PC 


Tic 
2e5s3 


CS BUS DATA INTEGRITY 


G2ABb6b6e2 


TABLE OF CONTENTS TIC CS BUS DATA INTEGRITY 
‘oO 0 TIC V.0S 
Moles le 5 CMPCA AND CMPCAM MODE DEFINITIONS eSBTTL TiC CS BUS DATA INTEGRITY 
NO. OF WCS MODULES = 0001 le S SWITCH REGISTER BIT DEFINITIONS PPRAAAERARRETKEREAAAEREREAAROREREAERAERRARERKERENR TERRA ERA ERA RR AREA 
04905206907 208%09+0As 082 0C fe § CONSOLE ADAPTER REGISTER DEFINITIONS 944 
le 865 IO BUS REGISTER DEFINITIONS sTESY 10 CS BUS DATA INTEGRITY 
te § MODULE AND BUS NAME ASSIGNMENTS } 
le 6 SECTION NUMBER 21 : TEST DESCRIPTION 
2=e 42 Tat CONSOLE ADAPTER REGISTER RESPONSE ; THIS TEST CHECKS THE DATA INTEGRITY OF THE C$ BUS BY FLOATING 
3e 144 732 CONSOLE "TO TO" REGISTER DATA INTEGRITY : A ONE AND A ZERO THRU A MICRO WORD, EXECUTING THE MICRO 
We 286 SECTION NUMBER Be : WORD, ANO CHECKING THE V BUS FOR PARITY ERRORS, 
; : : Be 206 723 CONSOLE "MCR" REGISTER DATA INTEGRITY ' 
Bre eg, veo eee Se 284 T04 «CONSOLE "IDCS" REGISTER DATA INTEGRITY ; SUBTST 1 = FLOAT A ZERO THRU THE CS BUS 
be 356 T05 CONSOLE RXONE AND TXROY REG DATA INTEGRITY ; SUBTST 2 = FLOAT A ONE THRU THE CS BUS 
DATA: 1010 T= 439 TQ6 TXREADY AND RXDONE INTERRUPTS ’ 
1011 B= S64 SECTION NUMBER 83 9 LOGIC DESCRIPTION 
000A B= S64 707 1D BUS DATA LINES DATA INTEGRITY ’ THIS TEST CHECKS THE ID BUS INTERFACE TO THE WCS MODULES, THE 
9 661 TAB Vv BUS SELF TEST ’ DATA INTEGRITY OF THE WCS MEMORY CHIPS AND THE DAYA INTEGRITY OF 
0002 1Q@0 777 SECTION NUMBER OG ' THE CONTROL STORE (CS) BUS, 
180 777 729 CONSOLE CLOCK CONTROL , 
TRACE: 000700, 000720 l= 903 TOA CONSOLE 10 CYCLE FUNCTION 1 ERROR DESCRIPTION 
FAILING MODULES: C.S, BUS l2~ 975 TAB CONSL FROM ID REG CLK CTRL & DATA INTEG ao ; DATA’ EXPECTED V BUS CHANNEL, BIT AND VALUE 
1301a7A SECTION NUMBER @5 ; RECEIVED V BUS CHANNEL, BIT AND VALUE 
MIC>SET STEP INST ) 1301078 TaC CONSOLE MAINTENANCE RETURN STARTING ; LOOP COUNT = INDICATES WHICH BIT IN THE 32 BIT GROUP IS UNDER 
a = 1481162 TaD RXCS REGISTER FROM THE ID BUS SIDE LINE ’ TEST, IeE, 1B8BIT Oy, 2EBIT 1, 3BBIT 2, ETC, 
MIC>LOOP ) 15-1282 SECTION NUMBER @6 NUMBER ' LOOP COUNT © INDICATES WHICH 32 BIT GROUP IS UNDER 
TPC = 000646 (SPACE BAR) 1501282 TOE TXCS REGISTER ON THE ID BUS ; TEST, TeE, 18 BITS<318G>, 2aBITS<63832>, 3BBITS<95364> 
Aa SACRE’ 1581367 SECTION NUMBER 87 ’ 
TPC = 000654 (SPACE BAR) aan 1601394 TOF ID BUS REGISTER ADDRESS INTEGRITY ’ NOTES THE EXPECTED AND RECEIVED V BUS CHANNEL INDICATES WHICH 32 BIT 
TPC = 000662 X «— ANY CHAR. TO RESUME 161599 SECTNO NUMBER @8 ’ GROUP HAS BAD PARITY IN IT, I,E. 102XeBITS<31300>, 
— NUMBER 1701535 T10 CIB INITIALIZE FUNCTION ’ 101XSBIT$<63232>, AND 1O8XMBITS<9S264>, 
FULL SPEED. INDEX 1721656 SECTION NUMBER @9 ’ 
1801677 Ti CONSOLE REGISTER DUAL ADDRESSING s SYNC POINT DESCRIPTION 
te «— CONTROL -C TO RETURN TO MONITOR 1901745 T12 WOES DATA REGISTER READ ' SUBTST 1 = SYNCUCe*TEST PATTERN IS ACTIVE ON THE CS BUS 
Mic> 2001774 T13 INITIALIZE THE CONTROL STORE ' SUBTST 2 © SYNCUD@@TEST PATTERN IS ACTIVE ON THE CS BUS 
2101817 SECTION NUMBER OA Joo 
2101817 T1a WCS ADDRESS REGISTER DNATA INTEGRITY PRS TISIETIILISI TESTIS ICES CSISIS CISTI IST S CETL OCST ISLET TILT ITI TaiTiii it! 
22-1906 T15 WCS ADDRESS REGISTER COUNT LOGIC aoasse Tice 
2301976 T16 MICRO STACK DATA INTEGRITY 2534 a0a5S4 INTTIALIZE 
2402061 SECTION NUMBER @8 2535 
2402061 T17 MICRO STACK DUAL ADDRESSING 2536 000556 SUBTEST 
252158 718 MAINTENANCE RETURN DATA INTEGRITY SASSI TOTLOLLTOTTOLVTTTTADTTODLDTTTTTTEDDUTTTTTTTETTTTTTOLTTTTTOTOTTTL EDA 
OPERATOR 2602327 SECTION NUMBER OC 80556 TICSis 
INPUT 262327 719 MAINTENANCE RETURN MICRO STACK INCREMENT 2537 9¢ 
UNDERLINED 2722372 MICRO STACK WRITE DISABLE 2538 : FIRSY FLOAT A ZERO THR THE CS BUS 
28e242u G 2539 ye 
2902530 T1 CS BUS DATA INTEGRITY 2540 
3002621 SECTION NUMBER OD 2541 900560 Loop J,i,3 1 LOOP COUNT FOR THE 3 BANKS 
30262} T1D PCS PARITY CHECKERS 2542 900570 LOIDREG USCAOR,TMP19Q 3 SELECT LOCATION ZERO 
PAGE # 3102748 TIE wCS DUAL ADDRESSING 2543 600576 Loop K,p1,3 » INITIALIZE THE CONTENTS OF LOCATION @ 
31062807 SECTION NUMRER GE 2544 AGG6e6 LOTOREG USCDAT,TMP1@2 9 eee 
32028405 TIF WCS OYNAMIC MEMORY TEST 2545 one614 ENDLOOP K tees 
3322959 720 UBEN FIELD DECODE 2546 
3403260 SECTION NUMBER OF 2547 Barbed Loop I,1,32 s LOOP COUNT FOR THE BITS IN A BANK 
3403962 T21 USUB FIELD "CALL FUNCTION® 2548 000632 LOIOREG USCAOR,TMP100,J 3 LOAD THE BANK ADDRESS 
3503168 T22 USUB FIELD "RETURN® 2549 820636 TMP101,7 » GENERATE THE TEST PATTERN 
3603229 SECTION NUMBER 10 2558 agreuy RLaAOP 
3623229 723 USUB FIELO "SELECT SPECIFIER* 2551 889646 LOITOREG USCDAT,TMP1Q1 3 LOAD INTO THE SELECTED BANK 
3703365 724 UJMP FIELD DATA INTEGRITY 2552 700654 FETCH 10000 : EXECUTE THE MICRO WORD 
ERROR SYNC POINT 
LOOP 
RANGE MICRO OIAGNOSTIC HARDCORE TEST] MACRO M10 20eAPReo77 10337 PAGE 29} 


SYNC4Cs TSTVB TMP103 3 CHECK THAT THERE WAS NO PARITY ERROR 


2555 AAC676 ENOLAOP I 9 CONTINUE WITH THE NEXT BIT 
INDEX 2556 802702 ENDLOOP J s CONTINUE WITH THE NEXT BANK 
2557 @A0706 SKIP SUBTST 
2558 
Sec. B@A712 CSERR: REPORT <CSBUS> s CS BUS BITCS) STUCK 
6@ 
2561 8aa722 SUBTEST 
SSISSAITIITATAIIASDTIDAIIAS AAA ADTAI DADO DS DSD SAAS DAAAT AOA AAAAA AAAS 
AABT22 TICS2% 


Loop and Single 
Example 


Figure 4-11 
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CONSOLE TERMINAL OUTPUT TABLE OF CONTENTS 


2>>TEST 


MICKO [DLIAGNOSTIC V.O0OS 

01702703, 

NO. OF WCS MODULES = 0001 

04905706207 208209 20AL OHS OC OLDSOE OF e10sllvsizvilsSvslAviSeidsiZs 
Be ee eae ceraeey eee 


1832 SECTION 3A 
TEST AS 


2F 9309312329337 34935756937 738739 


FAILING SECTION TEST 
NUMBER 
TEST: AS SUBTEST: 1 INDEX 


ERROR: 101E 


00000200 
00000000 
00000003 


q 


DATA: 


MIC>CLR SOMM: 1153 - (tF SYNC WANTED 

AT THAT ADDRESS) 
MIC>LOOP } -_ START SCOPE LOOP 
tc +— CONTROL -C TO STOP LOOP 


MIC>RET ,) 4— RETURN TO CONSOLE 
>>> <4— CONSOLE PROMPT 


OPERATOR 
INPUT 
UNDERLINED 


LOOP 
RANGE 
ERROR 
PC 
INDEX 


3 DWMOOA,MCR(400,3262) 
3 DWMOGA,MIC (400, 3262) 


12815 21°APR°1977 
14335 20°APR°1977 


MICROTEST PROGRAM LISTING 


MICRO 31(241) Mierocode file Page 7 


TEST AS CES REGISTER ALU N BIT 
CES REGISTER ALU N BIT® 


PAGE "TEST AS 


POSSESS HOHHSEOSESHEHHESESSHSHEEHHSSESHSEEESSESSSEHEHEHESESSHECECEREHHHEE HE 


Figure 4-12 


3 
’ 
: 1834 s44 
; ee s TEST AS CES REGISTER ALU N BIT 
’ ’ 
1 1837 3 TEST DESCRIPTION 
3 1838 3 THIS TEST CHECKS THE ALU N BIT IN THE CES REGISTER. THIS Ig DONE 
1: 1839 3 BY SELECTING THE ALU TO DO A+oB AND AB, AND FaB, WITH SPECIFIC 
3 1840 3 DATA PATTERNS ON THE AMX AND BMX TO CHECK THE LOGIC THAT GENERATES 
2 1841 3 THIS BIT, 
3 1842 3 
3 1843 3 SUBTST 1 © CHECK THE DATA PATTERNS THAT REQUIRE THE ALU TO 
9 1644 3 BE EXECUTING AN A*B TO GET THE CORRECT ALU DATA. 
TEST 1 1848 3 SUBTST 2 © CHECK THE DATA PATTERNS THAT REQUIRE THE ALU TO 
STARTING 3 1846 3 BE EXECUTING AN AwB TO GET THE CORRECT ALU DATA, 
LINE ’ pe ’ SUBTST 3 © CHECK THE DATA PATTERNS THAT REQUIRE THE ALU TO 
NUMBER teas : BE EXECUTING ANYTHIN BUT AN A4B OR A&B, 
: 1850 3 LOGIC DESCRIPTION 
3 1851 3 THIS TEST CHECKS THE LOGIC NETWORK ON THE CEH MODULE THAT GENERATE 
2 1852 3 THE ALU N BIT, AND THE MULTIPLEXOR ON THE ICL MODULE THAT FEEDS 
’ ee ! THE ALU N BIT IN THE CES REGISTER, 
: 1854 3 
3 1855 3 ERROR DESCRIPTION 
: 1856 3 DATA’ EXPECTED CES REGISTER 
: 1857 3 RECEIVED CES REGISTER 
3 1858 3 LOOP COUNT © INDICATES WHICH DATA PATTERN IS BEING USED, 
; Pe ’ (SEE THE DATA AT THE END OF THE TEST) 
3 : 
9 1861 9 SYNC POINT DESCRIPTION 
3 1862 3 SUBTST 1 = SYNCIYASCALY N BIT GETS LOADED 
: 1863 3 SUBTST 2 = SYNC{BeeALU N BIT GETS LOADED 
’ Ha ; SUBTST 3 © SYNCiCeeaLy N BIT GETS LOADED 
sf jee 
3 bacd PSSSHSSSAKSSSEERSSSSESSEEESHESSESEHHHEHESHSSEEHSEHSHEHHEEHEHESEHESHHHTEEES 
9 186 LT’. 
U 1414 0618,0039,0D08G,09F8,0000,10F 1 s 1868 ICLTS8s: NEWTST(,3) 
U 1015, 0018,0038,6580,0A80,0000,1018 : 1869 R(OJK(,10) ) ADDRESS OF AMX DATA 
U 1018» 40000003D.9180,0800/000001135 : 1879 89 CALL, J/UNJAM » CLEAR ANY SBI INTERRUPTS 
U 1019, @018,0038,7580,0A88,0000,1140 3 1871 RCL) AKC, 20) ’ ADDRESS OF BMX DATA 
U 1440+ 6019003877980, 0A9G/G00001141 : 9872 R(2) XC, 30) py ADDRESS OF EXPECTED ALU N BIT 
7 a Oe ter tet cue cuounooecets te 3 1873 DoX 6.88) 
11425 01600003C.0180+008000000001143 3 1874 DoD, LEFT? GENERATE MASK FOR N BI 
U 1143, 0001,003C,0180,0A98,0000,1144 : 1875 R13)_D SAVE : : 
: 1876 
: ie TLL 
3 $¢ 
: 1679 3 DO THOSE FUNCTIONS REQUIRING THE ALU TO DO AN A PLUS B 
: 1880 j0 
U 1144, 0818,0038,D580,09F0,0000,101A a 
° ° P ’ ’ ’ 3 1882 T8Sit RC (AC) oKE,6) SET THE LOP COUN 
U 101A, 0000,003D,0180,0800,0000,1124 : 1883 s#@ SUBTEST ; : : 
U 1018, 00005003C,018G,0A00,0200.1145 3 1884 ICLTSLysVA.R(Q) 
U 1145, 8000,803C,0180,C8GG,0000,1146 s 1885 D(BYTE).CACHE,P ) FETCH AMX DATA 
U 1146, 0001,003C,0180,GAA8,0000,1147 s 1886 R($).D 9 SAVE 
U 1147, 0000,003C,0187,0A08,0200,1148 3 18867 VAwRE1) 
U 1148, 49900,803C,0180,C800,0000,1149 s 1868 D(BYTE).CACHE,P } FETCH BMX DATA 
U 1149, 0001,203C,0180,09A8,0000,114A s 1889 RC(5)..D SAVE 
sa gopeL tele atec cea cece c sac s 1890 VAR £2) 
° ; C,0180,C800,0000,114¢ 9 1899 D({WORD),.CACHE,P 9 FETCH EXPECTED N BIT D 
U 114C, 0802,403C,0186,0800,0000,114D : 1892 0.D,8XT(WORD) oe parce 
U 114D, 0601,003C,0180,09F0,0000,101C 3 1893 RC (OEJ.D ) SAVE 
U 101C, 4900,003D,0180,0800,an00 OFD 89 20 ERLOOP 
y 101D, 4810,0038,0186,0970,0000,114E 3s 1895 DeRC {AE 
L14E, 0€801+0028,0190,0800,00000114 + 1896 D.NOT,D GENERATE INITIA E OF N BI' 
U 114F, 081C,2034,0180,0A18,0000,1150 3 1697 D_D,AND,R(3) MASK ES eed en are rae 
U 1150, 4810,0038,3180,3079,0000,1151 s 1898 ID(CES)..D,D.RC{GE) » INIT THE CES REGISTER 
U 1151, 0000,003C,0180,0A28,0000,1152 3 1899 LAB.R(5) 
5 11520 €000/003C,0180,0928,0000.1553 1 1900 LCWRC (5) » LATCH AMX AND BMX DATA 
» 0 : » EXECUTE THE TE 
115460 00002003C,31F A,2CA0,0090+1156 » 1982 QID({CES) ve rane 
: tee percha gato cetentenenebet 15) s 1903 Q.Q,AND,R63) » MASK 
° ’ 09180,0800,0010,1158 1 1904 ALU..Q°D,CLK,UBC 
YU 1158, 9000,013¢,a180,0800 8080. j01E 9¢ Bolten ease peorats 
¢ Gage ; a6 p ERROR?,RC(O ALU N BIT FAILED IN CE EG 
u rire DOO2 OOIG OUR LONChs BOB y 1358 : 1907 LAB.R(2) si aaah 
1159» 06180014,0580,0A80,0000,415A » 1908 R(GQIoLACK(.1) INCREMENT ADR OF AMX DATA 
U 115A, 4000,003C,0180,0A08,0000,115B 3 1909 LABR 1) ° 
U 1158, 9718,7014,0580,0A88,0000,115C : 1910 REG) LAK (21) » INCREMENT ADR OF BMX DATA 
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Microtest Scope Loop Example 
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AS shown in Figure 4-12, the operator has entered a Control C 
followed by a RETURN (RET) command. This sequence breaks the test 
loop and returns control to the console program. 


4.9.4 Microtest Single Bus Step Setup 

During microdiagnostic execution the error message shown in Figure 
4-13 is printed on the console terminal. As in the previous 
example, execution stopped on test section 3A. 


As in Paragraph 4.9.3, the error PC is a four-digit number 
indicating a microtest. A look at the section 3A listing indicates 
that the error PC is on line 1948. At this point it is decided to 
use the single bus step capability. 


A scan backward through the microcode indicates a possible loop 
between SYNC1B (line 1943) and ERLOOP (line 1936). A point in the 
loop is chosen to stop the microtest, in this case UPC 116C (line 
1948). The operator enters SET SOMM: 116C, which sets the stop on 
micromatch bit and loads 116C into the microbreak register. A loop 
command is then entered which initiates execution of the loop. 
When the loop reaches UPC 116C, the microtest halts and prints the 
UPC on the console terminal. 


At this point, the operator enters the bus cycle mode (set step 
bus command). Each time the operator types SPACE, a single bus 
cycle is executed and the UPC is displayed on the _ console 
terminal. At any point in the loop the operator may scope the 
current conditions. 


As shown in Figure 4-13, the operator has exited from step mode by 
typing any character other than SPACE. The program control flags 
previously set are cleared. The HI flag is set to restore the 
normal default case. A CLEAR SOMM is then performed to clear the 
Stop on micromatch bit and the microbreak register, then a 
CONTINUE is performed to begin normal test execution at the next 
sequential test (i.e., A6). If the operator feels that the problem 
has been cleared, it is probably more practical to start the tests 
over rather than to begin at the next test. 


4-37 


CONSOLE TERMINAL OUTPUT 


22e> TEST 

MICRO DIAGNOSTIC V.0S 
012022903» 

NO. OF WCS MODULES = 0001 


042057062077 08 2092 0A2 OBL OC re OD OE x OF v1 0Ovsilvil2v1sv149iSeildel7» 
18919»1Ax1BelCeoily1LEviF » 20% 2172292392 
2F 9309319329337 349 357369379387 399 SAP 


ERROR: 1026 


DATA: 


MIC>SET SOMM: 116C 
MIC >LOOP 


MIC>SET STEP BUS 
UPC = 116D 
UPC = 116E 
UPC = 116F 
UPC = 1170 


MIC>CLR FLAG ALL ) 
MIC>SET FLAG HALTI 
MIC>CLR SOMM ) 

MIC >CONT ) 


Figure 4-13 
Bus 
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TEST: AS 


MICROBREAK MATCH UPC = 116C 


(SPACE BAR) 
(SPACE BAR) 
(SPACE BAR) 
xX @— ANY KEY LEAVES STEP MODE 
tc. @#— CONTROL -C TO GET COMMAND MODE 


ra 


—_— 


SUBTEST: 2 


TABLE OF CONTENTS 


24925 726927928 9299 2A22Hs 2Cz 2s ZEP 


TEST 
NUMBER 
INDEX 


OPERATOR 
INPUT 
UNDERLINED 


THESE 2 STEPS 

RESTORE NORMAL FLAGS 
CONTINUE TESTING 

FULL SPEED, NEXT TEST 


LOOP 
RANGE 


Microtest Single 
Example 


1832 SECTION 3A 
TEST AS 


1149, 
114A, 
1148, 
114C, 
114D, 
101C. 
1010, 
114E, 
114F, 
1150. 
1151, 
1152, 
1153, 
1154, 
1156, 
1157, 
1158, 
1018, 
1O1F, 
1159, 
115A, 
1158, 
115C, 
1150, 
1152, 
115F, 
1160, 
1020, 


qaeececoaccecacacaqceacacaccaqaacaceccaceaecaca 


1021, 
1022, 
1023, 
1161, 
1162, 
1163, 
1164, 
1165, 
1166, 
1167, 
1168, 
1169, 
1024, 
1025, 
116A, 
1168 


STOP TEST ON 
MICROMATCH 


1160, 
116E 


cc(icc cqeccacacacacacacacac 


U 1176, 
U 1171, 
U 1172, 
U_1173 


U_116F, CAUCE mate 1176 


U 1926, LU TPE LED PLCC PCLT PELE 


A001,203C,0180,09A8,0000,114A 
6AA0,003C,0180,0A10,9200,1148 
0808, 483C,0180,C800,0000,114¢ 
0802,403C,0180,0800,0000,114D 
0601,003C,0180,09F8,0000,101C 
A004.003D4018A,0800,anGG.,10FD 
6810,09038,0180,0970,0000,114E 
08A1-0028,0180,0800,0000114F 
081C,2034,0180,0A18,0000,1150 
4810,0038,3180,3070,0000,1151 
0040,003C,0180,0A28,0000,1152 
000020030 40180,9928,000001553 
0010,8014,0180,0800,0010,1154 
0000.003C,31FA,2CA0,0097021156 
081C,0034,01C8,7A18,0000,1187 
@01D,2000,0180,0890,9010,1158 
4000,013C,0180,0800,0000,101E 
0801-203D,0180,09E8,0000,1109 
0000,0030,A0180,0A00,0000,1159 
AG618,0014,A580,0A8G,0000,115A 
A080, 003C 40160, 0A08,0000,115B 
A018,0014,0580,0A88,0000.,115C 
0000,003C0,0180,0A10,0000,115D 
0418500145098 ,AA99,00000115E 
@810,0038,0180,0960,0000,115F 
0019,8000,0580,09E9,0017,1160 
08000,013C,0186,0804,0900,1820 
4000,003C,9180.0840,0000,101B 


A018,0038,0980,09FE9,0000,1022 
0900,003D,0180,0800,0000,1124 
AGAG,0G3IC ,ALBAr GARG O20001161 
@0A8,803C,0180,C8A0,0000,1162 
80014003C,0180,0AA8,0000,1163 
08000,403C,01820,0A098,0200,1164 
AQGB,803C,0180,C8A0,A000,1165 
@001,003C,0180,09A8,0000,1166 
08A%6003CoA18G,AA10,020001167 
0000,403C,0180,C800,0000,1168 
9BA2,403C,0180,0800,0000,1169 
8@001,003C,0180,09F0,0000,1024 
0900,9030,0189,0800,9000,10FD 
0810,0038,0180,0970,G000,116A 
280150028 ,0180.0800,0000,116B 
bic CLEA 2189 ALB ence 6C¢ 


e000, 03Cea18a. 0426 ,0000/116E 
8800,903C,0180,a9 6F 


0090,903C,31F0,2000,0000,1171 
O@81C,07034,0160,0A18,0000,1172 
901D,2000, 0180,0800/0010,1173 
0808,013C,0180,0800,A000 


ce 88 <8 68 GS CS CO GF GS 8S CO SS GF CH SS CH FH CO CO SS TH ‘CE CO CS GH OO GS SS FE CO SO OH GS GD CO OF GE CO CO OF SO BO FO CS GS OO OO 


3 1948 


3 1943 


1944 
1945 
1946 
9 


MICROTEST PROGRAM LISTING 


SYNC1A8 


al 4 


TEST HEADER AREA 


RC (5).D 

VAwR E23 

D(C WORDJ..CACHE ,P 
D.D,SXTCWORD) 

RC (@E)..0 

ERLOOP 

DoRC CAE) 

DNOT,D 

DD ,AND,R(3) 

ID (CES).D,D0.RC (GE) 
LAB.Rf5) 

LCoRC £5] 
ALUQLASLC CLK, UBCC »BYTE 
QID(CESs) 
Q.0,AND,R(3) 
ALU.Q°D,CLK,UBCC 
Zz? 
ERROR2,RC(GD).0 
LABOR IB) 
RCAILACK( 1) 
LAB.R C1) 
RE1).LA+K(.4) 
LAB.R (2) 

R(Q] LAK, 2) 

DRC [OC) 

RC CaC)oDeK(,1) »CLK,UBCC ,BYTE 


Zz? 
J/ICLTSLi 


) SAVE 

9 FETCH EXPECTED N BIT DATA 

) SAVE 

9 GENERATE INITIAL VALUE OF N BIT 
9 MASK 

§ INIT THE CES REGISTER 


9 LATCH AMX AND BMX DATA 
9 EXECUTE THE TEST 


s MASK 
9 CHECK 


y ALU N BIT FAILED IN CES REG 

py INCREMENT ADR OF AMX DATA 

y INCREMENT ADR OF BMX DATA 
INCREMENT ADR OF EXPECTED DATA 
» CHECK THE LOOP COUNT 

9 CONTINUE 


PSSST STIIIIATIATIOIADATAATTAALATTTA SADA DODA DASA TAA TTA OTA DATTA 


§¢ 
s NOW CHECK THOSE PATTERNS REQUIRING THE ALU TO DO AN A MINUS B 


T8S2! 
ad 4) 


RC CACIK 6,2) 
SUBTEST 


ICLTSL2IVA.LR CO) 


8g 


Leak 
SYNCiBs ALU,LA*LC CLK, UBCC BYTE 


D(BYTE).CACHE Pp 
R(58)3..D 

VALRE1) 
D(BYTE)CACHE,P 
RC (5)..D 

VAR C2) 

Df WORD).CACHE,P 
DoD, SXTCWORD) 
RC (GE1..D 

HD aRC LOE 

DoNOT,D 


D,D 
LABSR (5) 


QjID(CES) 
0..0,AND,R(3) 
ALU.Q@eD,CLK,UBCC 


ERROR2,RC(0D)..0 


$ SET THE LOOP COUNT 
§ FETCH AMX DATA 
9 SAVE 


9 FETCH BMX DATA 
) SAVE 


) FETCH EXPECTED N BIT DATA 

§ SAVE 

y GENERATE INITIAL VALUE OF N BIT 
» MASK 

y INIT THE CES REGISTER 


p LATCH AMX AND BMX DATA 
§ EXECUTE THE TEST 


» MA8K 
» CHECK 


p ALU N BIT FAILED IN CES REG 
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CHAPTER 5 
MACRODIAGNOSTIC PROGRAM DESCRIPTIONS 


Sisk DEFINITION OF TERMS 

Module -- The diagnostic programs are written in a modular format. 
Each module (file) is a part of the program assembled separately. 
Modular programming allows the development of large programs in 
which separate parts share data and routines. 


Assembler -- The MARS assembler (which runs on a PDP-11) and the 
VAX-11 Macro assembler (which runs on a VAX-11) are programs that 
accept one or more source moduleS written in MACRO assembly 
language and produce relocatable object modules and symbol tables. 


Linker -- The VAX/VMS linker and the cross linker accept as input 
one or more native code object modules produced by the assembler. 
Linking consists of three basic operations. 


di Allocation of virtual memory addresses 
2. Resolution of intermodule symbolic references (global 
symbols) 
cir Initialization of the contents of a memory image. 
Program Defined Symbols -- Program defined symbols (and labels) 


are either internal or external (global) to a source program 
module. An internal symbol definition (and reference) is limited 
to the module in which it appears. Internal symbols used by the 
diagnostics are temporary definitions that are resolved by the 
assembler. 


A global symbol can be defined in one source program module and 
referenced by another. Global symbols are preserved in the object 
module and are not resolved until the object modules are linked 
into an executable program by the linker. 


Program Sections -- The assembler creates a number of program 
sections (.PSECT) within a module, according to directives by the 
program developer. In addition, any code that precedes the first 
defined program section is placed in the BLANK program Section by 
the assembler. 


Through program sectioning the program developer controls the 
virtual memory allocation of a program. Any program attributes 
established by the program section directive are passed on to the 
linker. ThuS program sections can be declared as_ read-only, 
non-executable, etc. Refer to the VAX-11l MACRO Language Reference 
Manual for an explanation of the various program section attribute 


functions. 


In the diagnostic programs, each test is given a separate program 
section. 
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5.2 OVERVIEW OF THE MACRODIAGNOSTIC PROGRAM 

The macrodiagnostic programs and the diagnostic supervisor are 
written in VAX-ll native code. Each of the programs (and _ the 
supervisor) consists of modules. These modules are separate files, 
which are assembled separately and then linked by the linker 
program. Each module contains one or more program sections. The 
program sections and routines are organized according to a common 
format and a set of conventions that enable them to interact with 
the supervisor. Note that the listings described in this chapter 
are those assembled by the MARS assembler and linked by the cross 
linker in compatibility mode. The format will change when the 
native assembler and linker are used. 


Seo MACRODIAGNOSTIC PROGRAM LISTING DESCRIPTION 

This section describes the program listings in general terms. 
Illustrations and examples are taken from the MBA RH78@ diagnostic 
program. The formats of the other listings are Similar. 


Each program listing begins with user information and a link map 
created by the linker program. The separate modules that make up 
the program constitute the rest of the listing. The first module, 
called the header, defines symbols and labels and provides 
routines that are called by other modules. The modules which 
follow contain the test routines. 


User Information -- The user information, which comes at the 
beginning of the listing, includes the following items. 


Program identification 

Copyright statement 

Program abstract 

Hardware and software requirements 
Prerequisites to running the program 
Load and start instructions 

Program description 

History of program maintenance 


Link Map -- The link map shows the virtual memory allocation of 
the total program image in the program section allocation 
synopsis. Figure 5-1 shows this synopsis for the MBA diagnostic 
listing. 


The program section allocation synopsis lists the program sections 
according to the order in which they appear in memory. A list of 
attributes and the base, end, and length are given for each 
program section. The base address is the virtual address of the 
first location in each program section assigned at link time. This 
number must be added to the relative addresses given in the module 
listings to determine the virtual addresses of specific 
instructions because the assembly addresses are all relative to 
the base of the program section. 
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VIRTUAL MEMORY ALLOCATION OF IMAGE "ESCAA,FEXE31" 
THIS ALLOCATION WAS PONE OW 2MeSEPH7& 
AT 12243 BY CROSS LINKER VERSION X4,6 


VIRTUAL MEMORY LIMITS: 
STACK SIZE (NEC, PAGES): 
VIRTUAL DISK BLOCK LIMITS COCTAL)s: 


IDENTIFICATIONS 


DYNAMIC MEMORY AVAILABLE (BYTES): 


DYNAMIC MEMORY USEN (BYTES) 3 


LARGEST FREE HOLE 


SIZE? 


NUMBER OF HOLES FREE? 


47 HOLES OF 4 
11 HOLES OF 8 


HOLES 
HOLES 
HOLES 
HOLES 
HOLES 
HOLES 
NUMBER OF P#=SECTS 


eer Nouv & 


le 
16 
a2) 
24 
32 


DEFINED: 


NUMBER OF GLOBAL SYNBOLS: 


BYTES 
BYTES 
BYTES 
BYTES 
BYTES 
BYTES 
BYTES 
18@ BYTES 


PROGRAM SECTION ALLOCATION SYNOPSIS? 


NAME 


<SABSS$>3 
<SHEADER> 3 
<STSTCNT>:? 

<, ABS o>? 
<, BLANK ,>3 
<ARGLIST>: 
<BUFFERS>3} 
<CLEANUP>: 
<DISPATCH>: 
<DISPATCH,X>3 
“HEADER CODE>: 
<INITIALIZE>: 
<SUMMARY>3 
<TEST AAi>: 
<TEST _A02>3 
<TEST_@@3>3 
<TEST Gauss 
<TEST G25>3 
<TEST_C26>: 
<TEST _G07>3 
<TEST A08>3 
<TEST,O29>53 
<TEST AIA: 
<TEST Giios 
<TEST Gi2>: 
<TEST_@13>3 
<TEST,_G14>3 
<TEST,O15>3 
<TEST_Ol16>3 
<TEST G17>3 


NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPTC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPTIC, 
NOPIC, 
NQOPIC, 
NOPIC, 
NQPIC, 
NOPIC, 
NOFIC, 
NOQPIC, 
NOPIC, 
NOP IC, 
NOPIC, 
NOPIC, 
NOPIC, 
NOPIC, 


USR, 
USR, 
SR, 
USR, 
USR, 
USR, 
USR, 
USR, 
WSR, 
USR, 
USR, 
USF, 
USR, 
Se, 
'ISR, 
USR, 
USF, 
WSR, 
USR, 
USR, 
USR, 
VSR, 
USP, 
WSR, 
WSR, 
WSR, 
LISP, 
US®, 
USR, 
USR, 


CON, 
CON, 
AVR, 
CON, 
CON, 
CON, 
CON, 
COM, 
CON, 
cor, 
CON, 
CON, 
CON, 
LON, 
CON, 
CON, 
CON, 
CON, 
COM, 
CON, 
CON, 
CON, 
CON, 
CON, 
CON, 
CON, 
CON, 
CON, 
CON, 
CON, 


LiVMYAPUA BWAAABSFF AnAARGAA 


1V 
“VG2ouV1 
5.3 
42752 
enous 
P1246 
BAYT 


GAuUSY 
ag7e 


ATTRTSUTES 


ARS, 
PEI, 
PEL, 
ARS, 
CEL, 
REL, 
REL, 
REL, 
REL, 
PEL, 
REL, 
WEL, 
REL, 
REL, 
KEL, 
FEL, 
REL, 
CEI, 
FFL, 
KEL, 
REL, 
CEL, 
PEL, 
PEL, 
CEL, 
PEL, 
CFL, 
REL, 
rel, 


°EL, 


AGB13e2 wuvi se 
RASE 
LCL,NOSHR, EXE, RD , WRT ABBANGAD 
LCL»,NOSHR,NOEXE, RD ,NOWRT @O0AU200 
LCL,NOSHR,NOEXE, RD ,NOWRY 20000284 
LCL,NOSHR,NOEXE,NORD ,NOWRT AAAADBCB 
LCL,NOSHR, EXE, RD, RT 2ONGN2BS8 
LCL,NQSHR, EXE, RD ,NOQWRT AAAAGLABC 
LCL, OSHR,NOEXF, RD , WRT BBnG20a0 
LCL,NOSHR, EXF, RD, wRT ABNB26aG 
LCL,MOSHR,NOEYE, RD ,NOWRT 282002672 
LCl.,»,NOSHR,MOEXE, RD ,NOWRT @Q00285¢6 
LCL,'sOSHR, EXE, RD ,NOWRT 2ANG2ZA02 
LCL,~NOSHR, EXE, RD , ¥RT @BADZ2E3C 
LCL,NOSHR, EXE, RD, WRT 202032094 
LCL,NOSHR, EXE, RD ,NOWRT B20032Aa0 
LCL,NOSHR, EXF, RD ,NOWRT 20203400 
LCL,NOSHR, EXE, RID ,hOKRT aagazseaana 
LECL»~NOSHR, EXE, RD ,ROWRT AGAGZAAB 
LCL,NOSHR, EXE, FD ,NOWRT ABPAL2AA 
LOCL,NOSHR, EXE, RD ,NOWRT 2eRRPU4Aae 
1CL,NOSHF, EXE. RD ,NOWRT FRAAG4EAA 
LCL,NOSHR, EXE, RO ,NOWRT 20004820 
LCL,NOSHR, EXE, RD ,NQWRT wnagseag 
LCL,/NOSHR, EYE, RM ,NOWRT BQV05CAA 
[CL,e,NOSFR, EXE, RD ,NOWRT 2ORAGABY 
LCL,MOSHR, EXE, RD ,*OKRT 2000689048 
LCL,NOSHE, EXE, RO ,*OuRT Banneceae 
LCL,HOSHR, EXE, RD ,NOFRT 2O0807GR0 
LCL,NOSHR, EXF, 8D ,NOXRT 22007802 
LCL»tOSHR, EXE, RD ,NOWRT 20R07C00 
LCL,NOSHR, FXE, RN ,NOwRT Gangagann 
Figure 5-1 


END 


ALHBUABA 
@2008281 
@AGA0287 
AABABSAA 
Q6QQ1AB8 
OABALE6S 
QOAB2SFF 
AAAN26OF 
BVaAALBUF 
G0AA2867 
AABA2ESA 
98003091 
22083290 
@0003355 
YGPC369B 
AUAP3987 
GABA415e2 
GAMALAAT 
OABB4SEL 
AGBA4773 
QABaSiFC 
AAGBSADT 
“VGBAS5SEOB 
ACAMET9D 
AAABGASY 
OASAEF AF 
A08Q7615 
AQGAATACE 
OQRBR8FFC 
A2AAR915B 


LENGTH 


22800088 
AGAAABBe 
QA2AG8A04 
PABAGARD 
O88601831 
QAABBSAS 
CAGAB682 
222G8R72 
2AGBB1EO 
A2@A00018 
@AGAA4SB 
MGA00256 
AQABBBBA 
0000156 
AQAGBB29C 
20000188 
8200753 
A2BACHBAB 
OAAAAIE2 
29680174 
22GRB9FD 
24080808 
anaaneac 
AAQGU79E 
@A2G@G25A 
260003308 
@8000616 
CAQAA22F 
OOBB13FD 
a9@8n159 
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Portion of the 


Program Section Synopsis, 
RH78@ (MBA) Diagnostic Program 
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The link map also lists the global symbols and their assigned 
values. Note that symbols used as labels point to routines in the 
diagnostic supervisor, if their values are over 196000. 


Figure 5-2 shows a portion of the global symbol table for the 
absolute program section in the header file of the MBA diagnostic 
program. 


The link map is a part of the listing created by the linker, but 
not a part of the actual program in memory. It always precedes the 
first file in the macrodiagnostic program listings. 


Header Module -- Like all of the modules in the program, the 
header module begins with a Table of Contents, a Copyright 
Statement, and a Revision History. 


The declarations section in the header module contains global 
symbol definitions for register bit names, data patterns, masks 
referenced by the program, and Macro definitions. This section 
constitutes the beginning of the program code. The own storage 
section in the header module contains program labeled data, such 
as drive addresses, and program text and format statements, 
containing the ASCII texts of error and status messages. 


The header module also contains code that generates the hardware 
and software parameter tables, report and print routines, 
initialization and clean up routines, and interrupt and exception 
service routines. 


The assembler prints a symbol table and a program section synopsis 
for the entire module following the last program section in the 
module. 


Test Modules -- The remaining modules in the program contain the 
tests, which are the main body of the program. Each module begins 
with a Table of Contents, Copyright Statement, and Program 
Maintenance History. The program code begins with macro 
definitions. A symbol table and program section synopsis are 
provided by the assembler following the last program section for 
each test module. Notice that each test begins a new program 
section. 


wee PILEs ESCAA1,ORJ31 TITLE RH78O HF 4NER IDENT: 5,3 20eSEP@1978 11304 

SEQ, NAME ALIGNMENT RASE END LENGTH 

8 <, ABS ,.>3 BYTE @ GAAAAAAA AAARBAGCA ARnYBAgaA 

GLOR4AL SYMBOLS DEFINED: 
$SENV APAGAACI $40 AAGAARAL ASSA AGAAASSA 
AASS AGAGAASS ANAPTER, CODE QAARAMAA ALL ACCASA81 
ALL, ONES QAQAFFFF ASP OFFSET AAAAALLGS ATA AAG0bBGA 
ATTENTION AGSL1A9AF ATTN B4ARAG1E BCR QGAGGGG10 
BLKSCSBI B4AGBB1C BLKSNN, COMO 1Aaruaga BR@ AA080C1A 
BR{ QAACBGII BRO Q@UAVUB12 BR3 GA4GGAG13 
BRGY AABAARLY BRS AGANABIS BR6 2G008016 
BR7 2AQPC9Q17 RYTED AAQAKnAUFF BYTE] GQOGFFAA 
BYTEe QAFFORLE PYTE3 FFAURAAVOA RYTE COUNT_MSK @GQQ0Q0FFFF 
CAR AAABAAIC CPF AAAPUARB CR QAggeAaag4 
CREDO, READ,_DATA 2naagaag CSR ABABALAA DATA, XFER,ABRT 8A001800 
DATA, XFER,DONE a@ana2eadgu DATA, XFER LATE aeeanaaa DEFAULT Gagadeaa 
DISABLE, LOG 3eoaagaa OMN aLnauaes oocc eaooeiag 
DPE AQBAABIO NER GAe@PAaLlaA DR AAGAGA14 
DRIVE OFFSET gvavensa DRIVE, SEL MSK AAGKEABA ORV, ERRMASK QSACEGAS 
DRV LINITMASK anee118a NRY AQEAAABA DS_4Sk OFFFFSFF 
OTE CAGK1EAA OT, ABORT APALAZA?YS OT. BUSY 80008800 
DVA PADZABBAG eet A“UUAALA ENABLE_PS GQ20AG8BA 
ERR avoadaga ERR CONF BuBKeanB EXT,REG_OFFSET a@agaa4aa 
FOQF QAGAF BOF FATL AAAIGS13 FERR GOGAGGG4 
FORCE, MEMERR AUDAB2FF HPPA CHANNEL BAABAALY HP$A DEVICE 84000018 
HP$B_ BR AACABA2I HPTR ORIVE APALANZ2] HPSB SLAVE 80200023 
HPS$B_TR AaACAaaGeA HPSL IIRVEC BGGAAAV2ZY HP$L_. VECTOR AGQGGB1C 
HP$Q. DEVICE OUBABLAA HPBST NEVICE AHP VUDAB ILF G2BAGSV) 
IMAPP Q@VEAAAID IMRCP AUBCAGIE IMBDP GAGOBG1F 
INTERRUPT LENBLE @2aanaG4 INT SEQ, TIMEQUT vaAuaavae INVRT MAP PAR 20008000 
INVRT,MA,CPAR uneeaaga INVPT_ MB, DPAR BuAKnBAAD IO, PAGE 20008888 
IPLR AAMBGAGAL? LOwARITTS | MSK BVU2VASF MAINT, MODE AABAGCBS 
MANUAL AAGBABA2 MAP 1 PATTRN QALERFFE MAP INVALID AAAGAA1G 
MAP OFFSET aagaagnsadg MAP PE aequraes MAP PTR MSK QAV1FEAQ 
MASS CNTRL_PE O7?A200AG MASS,CTOD AAALYAAG MASS DATA PE AGBAAA4A 
MASS,ECP AugAnaaEa MASS ,EXCP aeveauua MASS FATL oa1ecaaa 
MASS_,RUN AAAKOAAB MASS wCLk AAAUCAOA MBD0IBLSEL 29808000 
MBE AAAAAAAS MBE ASR YVUAARCIA MRE_CRI GAGGAG80 
MBE,CRe QAVAAAIG MRE, DRR ABNAABIC MBE OTR 40000018 
MBE_ER AAARABAS MBE MR BUGAAAAC MRE PARAM AABSGBE7 
MBE,SR aaaaagea MCLK gvavanane MISSED, XFER 09000100 
MOL BPAALAGS MSR PFAABRABLIA MULT__TX AB8AABAAG 
NEXUS OFFSET AAAALBBA NTPBLEO AUWAAAAF NI6BBLE1 ASAAAGFS 
NIBBLES] YUARAAFAG NTRBLES ACAAF2A02 NIBBLE4 AGQOFARAA 
NI@BLES AUF RAABA NISRLE6 BFUuv4aa NIBBLE7 FASCBARA 
NON, XIST _PRIVE viauauer NOGP APAGAABA NO,RESP_ CONF GACABBBG 
occ BAACAAI™D QP T AVAR2AAL PAGE, BYTE_MSK OOOABIFF 
PFLFIELD APHLABAS PF KIDTH OGB49R1S PGM INIT O@CB0B801 
PIP BEAYUH2RBA POWER DOWN AKBLEAAD POWER,_UP AALHARAB 
TK-1119 
Figure 5-2 Portion of the 


Global Symbol Table for the 
Absolute PSECT of the Loader 
File of the RH78@ (MBA) 
Diagnostic Program 
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5.4 DIAGNOSTIC PROGRAM AND SUPERVISOR INTERACTION 

Whether a diagnostic program is executed in the user mode or in 
the standalone mode, its relation to the diagnostic supervisor is 
basically that shown in Figure 5-3. Once a diagnostic program has 
been loaded and the diagnostic supervisor has been loaded and 
started, program control moves to the boot routine of the 
supervisor. This routine clears vector space, flags, mail boxes, 
and sets up the processor registers to a known state. The boot 
routine checks to determine whether the operator has typed a 
Control C and sets up a map of memory and I/O addresses creating 
P@ and Pl page tables. It then initializes the system control 
block and the process control block, and then calls the begin 
routine. 


The begin routine changes the processor mode to kernel and calls 
the CLI (the command flag should be set). The CLI types out the 
prompt symbol, DS>, indicating that the Supervisor is ready for 
commands. When the operator types in a command (e.g. START), a 
parser routine in the supervisor is activated to decode the 
command and call the requisite action routines, clear the command 
flag, and then call the dispatch routine. 


The dispatch routine forms the heart of the supervisor. It begins 
by clearing the error count and setting the pass zero flag and 
then calls the initialization routine in the diagnostic program to 
be executed. 


The initialization routine initializes the unit under test and 
sets up conditions in the CPU and on the SBI which are necessary 
to the diagnostic program. The initialization routine then 
questions the operator concerning the unit to be tested, creates a 
hardware parameter table (P Table), tests for end of pass, and 
returns control to the dispatch routine in the supervisor. 


The dispatch routine then calls the first test. At the end of each 
test, control returns to the dispatch routine. At the end of the 
last test in the program (or the last test selected by the 
operator), the dispatch routine in the supervisor calls the 
initialization routine in the diagnostic program. This routine 
determines whether or not the end of the current pass has been 
reached. If the end of the current pass has not been reached, the 
first test routine in the dispatch section of the supervisor is 
called, beginning another test sequence. If the end of the pass 
has been reached, the program calls the end of pass routine in the 
Supervisor. 


The end of pass routine in the supervisor determines whether or 
not the last pass to be run has been completed. If so, the cleanup 
and summary routines in the diagnostic program are called, the CLI 
command mode is set, and control passes to the begin routine which 
calls the CLI. The CLI prints out the DS> prompt symbol and waits 
for operator input. 
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DIAGNOSTIC DIAGNOSTIC DIAGNOSTIC DIAGNOSTIC 


SUPERVISOR PROGRAM SUPERVISOR | PROGRAM 
O® © © | reatnce 
CALL SERVICE 


BOOTSTRAP 
AND SUPER 


— FIRST ROUTINES 
TEST RETURN FROM 

SERVICE 

ROUTINES 


Greene 


——— 
CALL SERVICE 

TEST N ROUTINES 
omar senvice 


INIT ROUTINE 


BEGIN 
ROUTINE 


SERVICE 
ROUTINES 


FIRST 


PASS NO CALL NEXT — 
MODE) 


END OF PASS ROUTINE 7 


COMMAND LINE 


INTERPRETER | CLEAN UP 
ROUTINE YES a, 


(CLI) 


SUMMARY 
ROUTINE 


CONTINUE 
WITH 


START 
RESTART 


INTERRUPTED 
TEST ROUTINE 


[PRoGRAM INIT ROUTINE | 


BUILD P 
TABLES 
INITIALIZE 

DEVICE TO BE 
TESTED 


ener) anne GO TO BEGIN | | 
ROUTINE Aatiee | 
SERVICE 
| FIRST TEST SYSTEM eOuaiNcS 
| ROUTINE ace (PRINT ETC) | 
OF 


CALL CLI YES NOB RETURN TO TEST 
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Figure 5-3 Diagnostic Program 


and Diagnostic Supervisor 
Interaction 
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If the last pass has not been completed, the end of pass routine 
checks to see whether the operator has typed control C. If the 
Control C flag is set, control returns to the CLI. Otherwise, the 
end of pass routine calls the begin routine in the supervisor to 
initialize the system and initiate the next pass of the diagnostic 
program. 


Note that when the operator types Control C, he does not cause an 
interrupt routine to be called. The Control C merely sets a flag. 
The status of the flag is checked periodically when the tests in 
the diagnostic program call various service routines and at the 
end of a pass. 


5.5 ANALYSIS OF A SAMPLE TEST: RH78@ (MBA) TEST 3, SUBTEST 1 


5.5.1 Listing Column Format Description 

Figure 5-4 shows the program listing for the MBA RH78@ diagnostic 
program (ESCAA), test 3, subtest 1. The sixth column from the left 
contains the relative address of each instruction. These numbers 
begin at @ with the beginning of each program section. Note that 
the address offset of the program section containing Test 3 
(3600. _), found in the link map, must be added to the relative 
addres to find the virtual memory address of the instruction. 


The seventh column from the left contains the listing line 
numbers. These numbers begin at @ for each module of the program. 
Note that the line number increments for each line of the source 
module. The sixth column shows the program counter, containing the 
relative address. The relative address increases according to the 
amount of memory space required for the instructions and operands. 
Line numbers are present only for lines entered by the program 
developer. Macro expanSions do not have line numbers. 


The eighth column from the left contains labels used by the 
programmer as symbolic addresses. 


The ninth column from the left contains instruction mnemonics and 
Macro calls. Note that the Macro calls themselves require no 
memory space (the relative address does not change), and that in 
the Macro expansion which follows, the line number is not 
incremented (line 317). At assembly time, the assembler program 
responds to the Macro calls, expanding the Macro according to the 
definition listed at the beginning of the file. 


Column ten contains operands for those instructions contained in 
column nine; and it contains instruction mnemonics and parameters 
for the Macro expanSions. 


The eleventh column from the left contains operands from the Macro 
expansions. 


Column five contains the op codes (hex) for the instructions 
contained in columns seven and eight. 
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RH780, TESTS Lie JANOI97H 19366841 VANo11 MACRO XB,306 Pece 9 
2) TEST 2: INITIALIZATION TEST (3) 
V29C 284 S$SBTTL <CONTROL REGISTER 8a@ TEST> 
H29C eSB8TTL TEST 3 CONTROL REGISTER SAO TEST 
29C SS$S8TTL B83, <CONTROL REGISTER 8AG TESTD>, <PAGE> 
anaageaga ePSECT TEST, G83, PAGE, NOWRT 
GAaic 
agic 288 3(¢€3)) 
Baie 286 SAGNTEST <DEFAULT. ALL? 
YOIC DATA,G033 
aaganana eaic eL ONG 8 s TEST ARGUMENT TABLE TERMINATOR, 
aa2ea TEST, 00323 
amas ea2e «WORD = *Me> y ENTRY MASK 
an22 267 34 
aaee 248 3 
“A2e2 269 3 TEST DESCRIPTIONS 
AA22 298 3 
NF22 291 3 THIS TEST CHECKS FOR STUCK AT ZERO BITS IN THE RH78SG CONTROL REGISTER 
GA22 292 3 A CHECK [8 ALSO MADE TO INSURE THAT THE REGISTER WILL CLEAR VIA 
an22 293 3 THE DeINPUTS OF THE CONTROL REGISTER FLIP/FLOPS, 
sAa2e2 294 3 
APQQ 295 3 
AuQ2 296 3 
UAaZe 297 3: TEST ALGORITHMS 
4§¥22 298 3 
AQ22 299 3 WRITE ONE°S INTO EACH BIT, CLEAR VIA THE De INPUTS 
SA22 SAA 3 WRITE EACH BIT IN THE CONTROL REGISTER 
uA22 301 3 REPORT ERROR IF SELECTED BIT 18 NOT SET 
AQ22 302 3 
AA22 303 3 
§2 ABAGAAAGTEF Na ypaeze 3as MOVL RM, CUR, AOR,R2 ¢ MOVE RH78S8 ADDRESS TO R2 
AaeQg 306 ERRPREP RHKCRMSG,1,F MT, CONTRL, REG, $A9,"8G 9 PREPARE TO HANDLE ERROR 
‘AgaaaaaAarEF PAAAAAANT EF QE «a29 MOVAL RHCRM8G,REGNAME 
AAAGAALRAT EF O1 QA vAzU MOVZBL #1,RECG,NO 
BOBAAABE “EF AAP AAGAAT EF NE 9038 MOVAL FMT CONTRLLREG, REG STRING 
NAS 307 344 
AALS 3AB 3 TEST CLEARING VIA DeINPUTS 
“UAab 3A9 see 
“AUG 31¢ SAGNSUB 
8AQ6 T3,Siss 
CAAAAAAG?S OF AAAAABAATEF FA WAU CALLG $833, @#x08S8GNSUS 
aanaa’ce PAAAAAAAS BF cA AS} 31). 1483 BISt SPGM INIT, CR(R2) L_JINIT 
eAArC aE QA Aasa 312 MOVZBL #*KXE,CR(R2) 9 WRITE ONE°S VIA O INPUTS TO CONTROL REGIST 
7aaa°ce D4 GAase 313 CLRL CR(R2) + CLEAR VIA O INPUTS 
$3 aaaa*ce DA HAb3 314 MOVL CR(P2),R3 $ READ 4°8 FROM CONTROL REGISTER 
in 139 9768 315 BEQL 208 9 SKIP TF NO ERRORS 
Sq 0G O64 316 CLRL RY 9 CLEAR EXPECTED RESULTS REGISTER 
ve 317 SERRHARO,S #1,LUN, MIR, PRINT, SBE i] 
oo RR 
AAAAAAOAP EE NF sere PUSHAL MIR 
aaaaanaaa’ee 00 8978 PUSHL LUN 
@1 NO DIETE PUSHL #1 
ABAABAAAS OF Ou FR yvasba Cats #$3M, @#OSSERRHARD 
AAR? 3i& 2AS83 SCKLOOP 1a8 3 SCOPE LOOP? 
agagaaana’ oF C7 aF FA AQAT CALLG 198, @e#O08SCKLOOP 
PABE 319 SENOSUB 
Hear T3,81,X8 
asannannegr anagaaaarEcr FA vO@6F CALLG $$$, @#D08SENDSUA 
i | 
LISTING INST 
OPERAND INST LINE MNEMONICS OPERANDS 
SPECIFIER OPCODE | NUMBER AND FROM MACRO 
(HEX) (DECIMAL) | MACROS EXPANSIONS 
OPERAND 
OPERAND SPECIFIER PROGRAM MACRO 
SPECIFIER EXTENSION COUNTER EXPANSIONS 
EXTENSION (HEX) LABELS AND COMMENTS 
OPERANDO OPERANDS 
calla alba 
1 2 3 4 5 6 7 8 9 10 11 12 
TK-0736 
Figure 5-4 RH78@ (MBA) 


Diagnostic Program Test 3, 
Subtest 1, Listing 


Columns one through four contain the hexadecimal code for the 
operands specified in columns ten and eleven. Columns two and four 
contain operand specifiers. Columns one and three contain operand 
specifier extensions. Numbers followed by an apostrophe (e.g., 
OB9GOGG008') are the machine code for symbolic operands. They are 
modified by the linker at link time. (MARS is a one _ pass 
assembler. Forward references, with the exception of branches 
within P sections, and global symbols cannot be resolved until 
link time.) 


The twelfth column contains comments describing the functions of 
the instructions. Each comment is preceded by a semicolon. 


Dia a2 Analysis Of Typical Lines 

Line 311 -- The BISL instruction sets bits in the destination 
according to the mask provided. #PGM.INIT is the symbol for the 
mask. Its value (#9808001) can be found in the symbol table at the 
end of the module. CR is the symbol for the relative address 
(offset from the MBA base register) of the control register of the 
MBA under test. Its value (99800004) is also listed in the symbol 
table. This value is added to the contents of R2, the base address 
of the MBA under test, to produce the physical address of the 
control register. The instruction thus sets bit zero of the 
control register. The comment, INIT, indicates the function that 
setting bit zero performs. 


Line 317 -- SERRHARDS, in line 317, is a Macro call. The symbols 
that follow it are arguments to be used in the call. The five 
lines that follow line 317 show the expansion of the Macro. These 
instructions push the arguments on the stack and call the 
DSSERRHARD subroutine in the supervisor, which sets the error flag 
and prints an error message based on the stored arguments. 


5.6 RH788 (MBA) DIAGNOSTIC SAMPLE SUBTEST (Direct I/O) 


5.6.1 RH78@ Diagnostic Detailed Flow 

Each test in a given diagnostic program relies on subroutines 
provided by the diagnostic supervisor. The diagnostic program thus 
depends on the supervisor for services as well as initialization 
and test sequencing functions. The operator should be able to 
follow references and subroutine calls back and forth between the 
diagnostic program being run and the supervisor in order to uSe 
the listings. 


The general strategy used throughout the diagnostic programs 
involves writing and then reading back data directly (with MOVE 
instructions) in order to exercise the logic circuits or device 
functions under test. Data retrieved is compared with data 
expected. If the comparison indicates a failure, an error routine 
takes appropriate action and sendsS a message to the operator. 
Subroutine 1 of test 3 of the MBA diagnostic is representative of 
this strategy. This subtest determines whether the control 
register of the MBA under test can be cleared after each bit in 
the register has been set. 


When the diagnostic supervisor calls test 3 of the MBA diagnostic, 
the test initialization code moves the base address of the MBA 
under test to general register 2. This register is then used to 
index specific MBA registers. The ERRPREP Macro then stores 
information concerning test 3 in a buffer area for use in error 
messages. 


Subtest 1 begins with a call to the DSS$BGNSUB entry point in the 
Supervisor, as shown in Figure 5-5. In order to find this entry 
point, look in the global symbol table in the program link map 
(Figure 5-6). DSSBGNSUB equals 99918080380, an address in the 
Supervisor. Note that the first two characters of the symbol (DS) 
indicate that the symbol points into the diagnostic supervisor. 
The global symbol table in the link map for the supervisor shows 
that the entry module (ESSAA11) defines the symbol (contains the 
code for the entry point) (Figure 5-7). The names of the 
Supervisor modules suggest their functions (e.g., entry, loop, 
print). 


The DSSBGNSUB entry point contains only one instruction, a jump to 
RBGNSUB, as shown in Figure 5-8. This subroutine is in the loop 
module of the supervisor (Figure 5-9). RBGNSUB checks the subtest 
sequence for correct order. A discrepancy causes the subroutine to 
call a print routine, which displays an error message, and then to 
return to the CLI. If the subtest Sequence is correct, the RBGNSUB 
subroutine calls the KB-CHECK routine to check for Control C. If 
the operator has typed Control C, control returns to the CLI. 
Otherwise, control returns to subtest 1 which, at this point, 
begins testing the MBA logic. 
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DIAGNOSTIC 
SUPERVISOR 


ENTRY 
MODULE 


PRINT ERROR 
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CALL CLI 


$DSGNSUB 
ROUTINE 
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Figure 5-5 RH78@ (MBA) 
Diagnostic Program Test 3, 
Subtest 1, Flowchart 
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DISPATCH CALL TEST 
| ROUTINE 


——_e 
PRINT RPRINTF 
MODULE 
: RPRINTOUT 


STORE ERROR INFORMATION 
CALL ERROR ROUTINE 


MBA RH780 
DIAGNOSTIC PROGRAM 


SET UP 
BASE ADDRESS 


OF MBA 
UNDER TEST 


ERROR 
PREPARATION 


CALL BGNSUB 


RETURN TO SUBTEST INITIALIZE 


THE MBA 


WRITE ONES 
TO CONTROL 
REGISTER (CR) 


CLEAR 


CONTROL 
REGISTER 


NO READ 
ZEROS 


CLI 


DIAGNOSTIC SUPERVISOR 


ENTRY 


DSSCKLOOP 
MODULE 


Loop [ RckLooP 


YES 


LOOP 
FLAG 
SET 


ERROR 
FLAG 


FIRST 
LOOP AFTER 
ERROR CALL 


YES 


CORRECT 
LOOP 


YES 
SAVE PC 
LOOP ADDRESS 


RETURN TO 
BEGINNING OF 


SUBROUTINE 1 


CALCULATE | 


REND SUB 
SUBROUTINE 


MBA RH780 
DIAGNOSTIC PROGRAM 


CALL CKLOOP (a \ 


CALL 
OSSENDSUB 


TK-0506 


MIRLMOPLMCP_MSI G@U0MG6EPR MIR MSI AAGAAARBeER MIR, MSI{MCP Q4GAV6D2eR 
MIR MSILMCP_MDP (UG@GB7TA4eR MIA LMSILMOP OAQCUT4I—R MIR ,MSI,MDP_MCP 02000773eR 
MSI Q@ABVS9AB=@R MST{MCP GAABVAS9*R MSI MCP,MIR APCA2BABA=R 
MSILMCP MIR, MDP U2A9DAB2eR MSY,MIR @20009C3@R MSTLMIR,MCP UOAGOIEAmR 
MSTLMIR, MCP MDP ABAABSICeER MSRLSNAP AGAAAZFOeR NOODRIVE AAGAG2EBeR 
NO,UNITS AAG@D2B3—R NUMBER,RUFFER @4G0PS4eeR PTBASE 2OCGA02BUeR 
ASTLINITS ANBALI9S3eR REC,MSG QAGG1AFieR REG.NAME QAGAOS44eR 
REG,NO OABQG5S4BeR REG STRING GVAPASHCeER REPORT,BUFFER 00000340eR 
RHG AAAAB2BD—R RHI ABBAAZI{eR RHE GA0APG295eR 
RH3 BGQQB299"R RY SABVR29NeR RHS SCGCO2A1eR 
RH6 OCAGA2ZASeR RHI ACAAZ2A9®R RHACR,MSG GOA019330R 
RHCR,MSG OAQ@191DeR RHCSR MSG 9V201915eR RHDR,MSG Q202193BeR 
RHMAPR_ MSG GA001942eR RHSP_MSG QYUAKW1I924eR RHVAR,MSG 0000192B=R 
RH, ADR, TABLE BABUB2BNeR RH_FRLVL QAOUA2AEeR RH _CUR,ADR OGQAA28BeR 
RH, TRLVL AADAB2AD]-R SAP.MSG BAUJIBCE=R SA1,MSG 400018098R 
SFTP TABLE Q@QOP1ABS=R SUFFIX,PTR ANMAPGS5S4eR TEMP Q0@@OSSCeR 
TIMOUTLEVT FLAG @@9G02E6<R TIMOUT,RET,PC 1 GOAVUZET@R UNEXPECTED BNOG18EUeR 
WAIT, TIME QEAAB2ECER 
2 €S$HEADER>? PAGE 9 PAVPAAYHA PABAY2BI ApABAAGBe 
3 <€,LAST>3 PAGE 9 VAGABEAA BAAPBEG@A AAnAaaUD 
4 <STSTCNT>3 LONG 2 HA2AAACRY PAANKE2BY BGAVAVAGB 
5 <SABSS$>3 BYTE @ UALAAABG AAAAAGRGS AALBVAAA 
GLOBAL SYMBOLS DEFINED: 
OSSABORT g001a02e9 DSEASKADR agaianga DSSASKDATA go01ga8ea 
OSSASKLGCI DSSASKSTR AAV1ADAG OSSASKVLD 20010088 
| DSSBGNSUB sss BG B1 8854, OSSBREAK 00018058 OSSCANWAIT 00019070 
SSE CHANNE 30 DSECKLOOP aagiaqanua OSSCLRVEC 00010168 
OSSCNTRLC 04010078 OSSCVTREG AAA1ARBA OSSELOGOFF o0010108 
DSSELOGON 229010100 OSSENDPASS QPALAGIA DSSENDSUB 92010038 
OSSERRDEV GAB1GACB OSSERRHARD ang1aaDe DSSERRSOFT 80010008 
DSSERRSYS argiaece DSSESCAPE aea1aasa OSSGETBUF 98210120 
OSSGETMEM a9018132a DSSGPHARD 900148918 NSSINITSCA 20010170 
OSSINLOOP 90013048 OSSMMOFF @2017158 OS$MMON 070120150 
OSSMOVPHY @0018148 DSSMOVVRT guaialua DSSPARSE 20010088 
OSSPRINTB AGBIBBEV OSSPRINTE ALALGPFQ OSSPRINTS G00100F8 
DSSPRINTX OA2019R0E8 DSSRELBUF 906129128 OSSRELMEM 02010138 
DSSSETIPL 27010178 OSSSETMAP aouie18a OSSSETVEC 09010160 
OSSSHOCHAN eaa1aigon DSSSUMMARY 97910628 OSSWAITMS 20010060 
OSSWAITUS 27010968 SYSSALLOC 90010238 SYSSASSIGN 00010250 
SYSSBINTIM 9a010258 SYSSCANCEL QAALa2oa SYSSCANTIM ‘80010268 
SYSSCLREF 20018298 SYSSDALLOC 90010208 SYSSOASSGN 200102E0 
SYSSGETCHN 920164C8 SYSSGETTIM @0018378 SYSSQIO A00103C8 
SYSSQIOW aaa1d200 SYSEREADEF araies3on SYSSSETEF g0210400 
SYSSSETIMR aaaindea SYSSSETPRT ArALB43A SYSSWAITFR 20010478 
SYSSWFLAND AGBZ1iAgAR SYSSWELOR eeainaga 
6 <DISPATCH>: LONG 2 AAAV267% AAAG2670 earenaea 
7 <DISPATCH,X>3 LONG 2 CAUA285A Gaae2867 ABeAABIB 
TK-1120 
Figure 5-6 DSSBGNSUB Listed 


in the Symbol Table in the 
ESCAA Link Map 
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ZZ~ESSAAe4. Od Map Fiche 1 Frame Li Sequence 11 

DMA13 (340, 4AJESSAA, EXE 9 467 3G~AUGO1978 29231 LINKER X@1,20 PAGE 18 

SYMBOL VALUE DEFINED BY REFERENCED BY oe. 

gta ee eaeaee Zen eauv 8a ® Se eegqeaevwveeseaesaanyu 

DRASUCB2 POALB4EBaR IOBASE ,ESSAA43 DEVICE, ESSAA9 

DRASUCB3 2@001B588eR IOBASE,ESSAA43 DEVICE, ESSAA9 

DSSAA,BPTADDR OAALZFDGeR DEBUG,ESSAA8 ERROR _ESSAAL2 LOOP SCBLESSAA23 

DSSABORT AQALABG202R ENTRY,_ESSAAI1 FRKCTLLESSAAG{ TOSRAM _ESSAAU6 LODMAP_ESSAAUT 
PARAM ESSAA19 QIOREG ,ESSAAS1 SCBLESSAA23 

DSSABORTWAIT AAGIAAT|IeR ENTRY _ESSAAI1 

OSSAB_BPTINST QAAL2FCAeR DEBUG,_ESSAA8 ERROR, ESSAAI2 LOOP 

DSSAQ_SSEND AGOLATFFeR ENTRY ,ESSAA11 KERNEL, ESSAAL5 

DSSAQ,SYSSRV GIGI A20AER ENTRY,ESSAA11 KERNEL ESSAAI5 MEMMGTLESSAAL8 

OSSASKADR AABIABIGER ENTRY_ESSAAL1 

DSSASKDATA QUAI GAEBeR ENTRY,_ESSAA11 

OSSASKLGCL 2A910098eR ENTRY,_ESSAAI1 

DSSASKSTR AAAIBZAG=eRL ENTRY,ESSAA1I1 START,ESSAA25 

DSSASKVLD ADALAGBBeR ENTRY, ESSAA1L! DEVICE, ESSAA9 

DSSAX SOFTPCB OUGIE7AQER KERNEL, ESSAALS ASSIGN, ESSAA36 ASTDEL,ESSAAI CANCEL, ESSAA37 
CHMK ESSAAG NASSGN ESSAA3B DEVALC_ESSAA4B 
IOPOST _ESSAAS2 

OSSA.PRGBGN enabg2an ESSAA15 APT LOAD, ESSAA16 

SSSE : JAGIAASGeR —_—ENTRY ESSAAI{ | 

USSBREAK AAGiASSBHR ENTRY _ESSAAIL1 APT 

DSSCANWATIT OAB1IAG7TA#R ENTRY,_ESSAAI1 CLOCK, ESSAA6 

DSSCHANNEL YAG1A1BASR ENYRY,_ESSAA114 

OS$CKLOOP AADIABUBER ENTRY _ESSAAILI 

DSSCLI AVALSABIeR CLI,ESSAAS DEBUG, ESSAA8 SCBLESSAA23 UBAINTLESSAASS 

OS$SCLRVEC AAADLAL6BeR ENTRY ,ESSAAI1 CHANNEL, ESSAA3 DEVICE ,ESSAA9 MEMMGTLESSAAI8 
START,ESSAA25 

OSSCNTRLC YAGLASTBER ENTRY,_ESSAA! 1 DISPAT,ESSAAIB 

OSSCVTREG GAALGIBAHR ENTRY _ESSAA1! CHANNEL_ESSAA3 DEBUG _ESSAA8 FLAGS _ESSAAILG 
SCB,ESSAA23 

DSSDOSUMMARY GYVG1IAB26eR ENTRY,_ESSAAI14 

OSSENDPASS AAALAGIB=R ENTRY_ESSAAI1 

OS$SENDSUB UVB19G38=R ENTRY,_ESSAA1} 

DSSENTRY QYUB16621eR VERSION, ESSAA33 

DSSERRDEV avaiaacserR ENTRY _ESSAA11 

OSSERRHARD AAGL@GDAeR ENTRY_ESSAAI1 

DSSERRSOFT ABYIBADSHR ENTRY_,ESSAA11 

DSSERRSYS ABALAACBeR ENTRY,ESSAA!1 

DSSESCAPE AABI@YSGeR ENTRY,_ESSAA$1 

DSSGA,BREAKVEC 429013568=R SCBLESSAA23 

DSSGA,BUFPTR BGGL1318C=R KERNEL, ESSAA15 

OSSGA,CHKLPPC A601316@eR KERNEL ,ESSAAIS DISPATLESSAAIA& ERROR, ESSAAI2 LOOP 

DS$GA_CHMKVEC AGAQ13S84eR SCB,ESSAA23 CHMK ESSAAU 

OSSGA,LASTADR AAG1316BeR KERNEL, ESSAA15 MEMMGT _ESSAA18 

DSSGA,LOOPADR  @2@013164eR KERNEL LESSAAI5 LOOP 

DSSGA_PBASE 04013568=R PARAM, ESSAA19 DEVICE,ESSAAQ STARTL_ESSAA25 

OSSGA,TBITVEC 2001356CeR SCB,ESSAA23 

OS$GB. BYTEBUF 40013190eR KERNEL, ESSAAI5 CONSOLE 

DSSGETADDRESS QAG1GG9GeR ENTRY,ESSAA1I1 PARAM _ESSAA19 

DSSGETBUF 2981012MeR ENTRY,_ESSAAI1 MEMMGTLESSAAI8 

OSSGETDATA 0001GG600eR ENTRY_ESSAA11 PARAM, ESSAA\9 

OSSGETLOGICAL GGG1GN9BER ENTRY,_ESSAAI1 PARAM _ESSAAL9 

OSSGETSTRING G@A@L1GGABeR ENTRY _ESSAA11 PARAM, ESSAA19 

OSSGETVIELD A0018C8BeR ENTRY,_ESSAA1L1 PARAM. ESSAA1L9 

OSSGL,BUFCNY 0041 2EO6eR BUFFER, ESSAA2Q KERNEL, ESSAAI5 MEMMGTLESSAA18 

OS$GL,BUFLEN 20013188eR KERNEL ESSAAIS5 PARAM. ESSAA19 PRINT aeaes 

Figure 5-7 DSSBGNSUB Listed 


in the Symbol Table in the 


Supervisor Link Map 
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ZZ@ESSAAe4, 04 
ENTRY _ESSAA11 
G68 


ENTRY POINTS TO THE DIAGNOSTIC SUPERVISOR, 


DIAGNOSTIC AND STARLET SERVICE ENTRY VECTORS, 
ENTRY POINTS TO THE OIYAGNOSTIC SUPERVISOR, 


AAAGAGAA’ EF 


AU AUAAUTEF 


APCABBAB°EF 


CAAAABOO°EF 


VACABABA° EF 


FFA3° 


VAACAABOA° EF 


VEYAAGARPEF 


APANGAONTEF 


ABBAGAR2° EF 


QOAG 
17 


AGAC 
17 


BaAaA 
17 


A0AQ 
17 


g0aa 
39 
a4 


BANG 
17 


A009 
17 


0282 
17 


8000° 
17 


171 
172 


2aA 
ea} 
ene 
243 
eau 
2as 
2a6 
eaTy 
208 
209 
210 
eit 
el2 
213 
214 
215 
216 
217 
e218 
219 
229 
221 
e2e 
223 
224 


> 42.1 


ALI 


DSSBGNSUB3?2 
e XORD 
JMP 


is N 


DSSENDSUBS? 
WORD 
JMP 


e ALIGN 
DSS$CKLOOP?:: 

e WORD 

JMP 


eo ALIGN 


' DSSINLOOPSs}: 


eWORD 
JMP 


e ALIGN 
OSSESCAPES: 

~WORD 

JMP 


e ALIGN 
OSSBREAK3 3 

e WORD 

BSBW 

RET 


eo ALIGN 
DSSWAITMSS: 

eWORD 

JMP 


e ALIGN 
DSSWAITUSS:8 

eWORD 

JMP 


eo ALIGN 
DSSCANWAIT33 
DSSABORTWATITS$3 

eWORD 

JMP 


e ALIGN 
DSSCNTRLC83 


e VECTOR 


JMP 


Fiche 3 Frame J9 Sequence 528 


22~AUGe1978 08322806 VAXei{1 MACRO X8,326 Page 6 
(4) 
PROGRAM CONTROL SERVICES, 
QUAD 
BEGIN SUBTEST ENTRY POINT, 
-M<> ENTRY MASK 
RBGNSUB 
QUAD 
3 END SUBTEST ENTRY POINT, 
*M<> s ENTRY MASK 
RENOSUB ; 
QUAD 
¢ CHECK LOOP ENRTY POINT, 
-M<> 3 ENTRY MASK 
RCKLOOP 3 
QUAD 
3 IN LOOP ENTRY POINT, 
“M<> : ENTRY MASK 
RINLOOP 3 
QUAD 
—y ESCAPE ENTRY POINT, 
“M<> 3; ENTRY MASK 
RESCAPE ; 
QUAD 
: BREAK FOR DYNAMIC SERVICES, 
*M<> : SAVE NO REGISTERS 
KB, CHECK 3 CHECK KEYBOARD 
QUAD 
: WAIT MILLISECONOS ENTRY POINT, 
“M<e> , ENTRY MASK 
OSXSWAITMS 
QUAD 
3 WAIT MICROSECONDS ENTRY POINT, 
“M<é> s ENTRY MASK 
DSXSWAYTUS 
QUAD 
: CANCEL WAIT ENTRY POINT, 
-M<> 3 ENTRY MASK 
OSXSCANWAIT 
QUAD 
; *xX10078 
DSXSCNTRLC 
OSXSCNTRLC+2 
TK-1122 
Figure 5-8 DSSBGNSUB 


Entry Point 


5-15 


ZZ=ESSAAw4 04 Map Fiche 1 Freme £2 Sequence 17 
OMA13 (340, 4G) ESSAA,EXE3467 30-AUG1978 09231 LINKER X@1,20 PAGE 16 
SYMBOL VALUE DEFINED BY REFERENCED BY eee 
Sut®es eo eegeee @eeeuUees vge eee evesegaceseseaeeaues 
PREADVBLK AORLTITGHR CONSOLE GIO, ESSAA22 
P guasaaes SYSVECTOR DEBUG ESSAAB 
: ; NT he Y RAY] 
RCKLOOP EAALS3IGER Loop ENTRY,_ESSAAI1 
RCTRLC PUA1SOSBeR KERNEL ESSAAILS 
RE ADVBLK a Ag QaR ONSOL QITO,ESSAA22 
LRENDSUB ISOC EeR = CLQOPC“‘“(‘C;OCOC*C*C*C*NTRYCESSAATI CO 
RERRDEV AAVLEI6FeR FRROR,ESSAA1L2 ENTRY, RAL 
RERRHARD ~AYAL4BS9eR ERROR, ESSAA12 ENTRYLESSAAI! 
RERRSOFT YVAYVLIGAUZeR FRROR,ESSAAI2 ENTRY ,ESSAA114 
RERRSYS PAU1USBReR ERROR, ESSAA1L2 ENTRY,ESSAAI3 
RESCAPE BOALS2UCeR LOOP ENTRY,_ESSAA11 
RGETADORESS QANISSFEeR PARAM, ESSAAI9 ENTRY ,ESSAA{1 
RGETDATA A4YALSS7TCeR PARAM, ESSAAI9 ENTRY ,ESSAA1L1 
RGETLOGICAL UYUISb6AQeR PARAM, ESSAAI9 ENTRY, ESSAA(L4 
RGETSTRING H8A15779eR PARAM ,ESSAA19 ENTRY_ESSAAI1L 
RGETVIELD VAAI5SS&UeR PARAM. ESSAAI9 ENTRY,_,ESSAAIL] 
RGPHARD BUAISABBeR PARAM, ESSAAI9 ENTRY,ESSAAI1 
RYNLOOP ABUWIS3BCeR Looe ENTRY _ESSAAL 
RPTEADR ASAITCH1LSR MEMMGT_ESSAA18 QIOFNT,ESSAASA 
RTYPEMSG AYN1I5SDAbER PRINT CLILESSAAS DISPAT_ESSAAI@ PARAMLESSAAI9 
SCB,ESSAA23 START, ESSAA25 
SCB BASE APALESOGeR KERNEL, ESSAA15 SCBLESSAA23 
SCBL IMAGE AZA1GAAA@R SCB,LESSAAQ3 KERNEL, ESSAA15 
SCHSASTOEL UA ALB9OFUeR ASTDEL,ESSAAI SCR, ESSAA23 
SCHSNEWLVL AAGIBAL3=R ASTDEL ESSAA1 CHMK,_ESSAAU 
SCHSQAST VPBIBAEASR ASTDEL,ESSAAI CLOCK, ESSAA6 IOPOST _ESSAAS2 
SEC, TICK AABCAKEY CLOCK, ESSAA6 KERNEL, ESSAAI5 
SGNSC _IRPCNT anauvuda KERNEL, ESSAAI5 MEMMGT_ESSAA18B 
SGNSGL_LIRPCNT Y~3BB1IC3E%eR KERNEL, ESSAAIS MEMMGTLESSAAI8 
SGNSGL,NPAGEDYN @vyiC3CCeR KERNEL, FSSAAIS5 MEMMGT_ESSAAILB 
SSS ,ARORT AUYPYAAZC SYSVECTOR TMORVR,ESSAA5S7 
SSS, ACCVIO AaMaABAAC SYSVECTOR ACPFOT ,ESSAA35 DEBUG,_ESSAAS QIOREG,ESSAAS! 
SSS, BADPARAM asuvaula SYSVECTOR ACPFOT ,ESSAA3S 
SSS, BREAK PuAuaaiLa SYSVECTOR DEBUG,ESSAAB 
SSS BUFRYTALT UVAIB3AC SYSVECTOR DMDRVR,ESSAAS53 
SSS CANCEL avaraBse SYSVECTOR CANCEL, ESSAA37 
SSS CMODSUPR VABAB4IC SYSVECTOR DEBUG, ESSAAB 
SSS, CMODUSER AAANAL2QK SYSVECTOR DERUG,ESSAAB 
SSS _COMPAT AAARBUEC SYSVECTOR DEBUG, ESSAA8 
SSS CONTINUE nAAaaAval SYSVECTOR DERUG,ESSAAS8 
SSS ,CONTROLC ABCIAAGS 1 SYSVECTOR CONSOLE 
SS$,CTRLERR OuHesnoS4 SYSVECTOR DBDRVR,ESSAA39 OMDRVR,ESSAA53 DRORVR ESSAA54 
TMDRVR ESSAAS7 
SSS ,DATACHECK guaeAesC SYSVECTOR DBORVR,ESSAA39 OMORVR ESSAAS3 DRORVRLESSAASA 
TMORVR ESSAAS7 
SSS ,DATAOVERUN 90N20838 SYSVECTOR TMDRVRLESSAAS7 
SSE_DEVFOREIGN anananed SYSVECTOR ACPFOTLESSAA35 
SSS,DEVNOTMOUNT @442027C SYSVECTOR ACPFOTLESSAA35 
SSS ,DEVOFFLINE 20nvaGB4 SYSVECTOR QIOREG ,ESSAAS1 
SSS, ORVERR ABWAUAGBC SYSVECTOR DBDRVR ESSAA39 DMDRVR,ESSAASS DRORVR_ESSAASG 
TMDRVR,ESSAA57 
SSS, ENDOFFILE QAAABBTA SYSVECTOR ACPFOT,ESSAA35 IOPOST,ESSAAS2 TMDRVR ESSAAS7 
SS$ ENDOFTAPE AAa08878 SYSVECTOR TMORVR,ESSAAS7 
TK-1123 
Figure 5-9 RBGNSUB Listed in 


the Symbol Table in the 


Diagnostic Supervisor Link Map 
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Subtest 1 initializes the MBA under test by writing a one to bit 
zero of the control register, the initialization bit. The subtest 
then writes ones to the control register, writes zeros, and then 
reads the register. If zeros are not returned from the control 
register, the subtest calls the DSSERRHARD entry point in the 
Supervisor. The DSSERRHARD code is in the supervisor entry module, 
ESSAA11 (see the supervisor link map). DSSERRHARD causes a jump to 
RERRHARD, which is located in the error module of the superviSor. 
RERRHARD sets the error flag, rings the bell if the bell on error 
flag is set, and calls the DSSPRINTF entry point. Like the other 
DS$ entry points, this one is located in the entry module and 
contains only a jump instruction. The jump transfers control to 
the RPRINTF routine in the print module (See the Supervisor link 
map). RPRINTF, in turn, calls the RPRINTOUT routine, also in the 
print module. This routine prints out a message on the operator's 
terminal indicating the test and subtest numbers, the logical unit 
number (LUN) under test, and the failing module name (MIR). 
RPRINTOUT returns control to RPRINTF, which returns control to 
RERRHARD, which returns control to ESCAA test 3, subtest l. 


At this point, the testing and error reporting portions of subtest 
1 have been completed. The subtest then calls DSSCKLOOP (in the 
control module of the supervisor). This entry point causes a jump 
to the RCKLOOP subroutine, which is located in the loop module. 
Unless the loop and error flags are both set, control returns to 
the subtest, which in turn calls DSSENDSUB in the supervisor to 
terminate subtest 1 and start the next subtest. 


If the loop and error flags are both set, the loop address is 
calculated and the RCLKLOOP routine causes a jump back to the 
beginning of subtest 1, at label 19$. Note that if the loop is the 
first loop after the error call, the test and subtest numbers are 
checked. If one of these numbers iS wrong, control returns to the 
Subtest as if the loop flag were not set. After the first loop, 
the subtest will be repeated continually. 


5.6.2 RH78@ Diagnostic Sample Error Message 

The error messages generated by the RH78@ diagnostic vary, 
depending on the type of error detected and the type of the 
failing test. However, in all cases the error message will 
identify the failing module (or bus Signal) and the nature of the 
failure. Expected and received data are printed when meaningful. 
For example, if bit 2 (IE) of the MBA control register is set, the 
error message printed will look like that shown in Figure 5-19. 


#keKKEXEMATINDEC ZZ-ESCAA-5.0 RH780 DIAGNOSTIC-5.0**##**H* 
PASS 1 TEST 3 SUBTEST 1 ERROR 1 1-JUN-1978 10:53:30.70 


HARE ERROR WHILE TESTING MBA: FAILING MODULE: MIR(M8276) 


(RHCR) =00000004 


EXPECTED: ZERO 
RECEIVED: IE 


XOR: IE 


TK-0780 


Figure 5-18 ESRCA Sample Error Listing 


Use the test, subtest, and error number to look up the relevant 
code in the program listing. Notice that test 3, subtest l, error 
l1 is the portion of the program discussed in the previous 
paragraph. The program sets the maintenance bit in the control 
register. It then writes ones to the control register, clears the 
register, and reads the register. Since bit 2 is stuck at one, the 
received data and the expected data do not match. 


After listing the failure, the program continues with the 
Succeeding tests. The operator may, at this point, shut down the 
computer to change the MIR board as directed, or use the 
diagnostic supervisor commands to set up a scope loop and monitor 
the failure more closely. 


oa | RP@X/DCL REPAIR DIAGNOSTIC (DIRECT I/O), SAMPLE SUBTEST 


Safed Detailed Flow 

The RP@X/DCL Repair Diagnostic (ESRCA) is representative of the 
peripheral diagnostic programs that use direct I/O. Like the 
cluster diagnostic programs, the RP@X/DCL repair diagnostic 
accesses registers on the unit under test directly, with move and 
bit set instructions and the like. However, the RP@X/DCL repair 
diagnostic relies more heavily than the MBA diagnostic on services 
provided by the diagnostic supervisor. In particular, it uses the 
channel services of the supervisor to perform such functions as 
initializing a channel, aborting a function, enabling and 
disabling interrupts, setting map registers, defeating parity, and 
determining adapter and error status. 


For example, when the dispatch routine in the supervisor calls the 
First test in the RP@X/DCL repair diagnostic, the test routine 
gets the address of the device under test and then, pasSing a list 
of arguments, calls for channel services through the DSSCHANNEL 
entry point in the supervisor. Figure 5-11 shows the code for 
test 1, subtest 9, errors 1-3. Figure 5-12 shows the subtest flow. 
DSSCHANNEL calls DSXSCHANNEL, which in turn, calls the BLDCDB 
Subroutine, which builds a channel data block containing the 
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S2 


988000800 ° 9F 
53 


28088000" 9F 
OA000000°EF 


@9000000° 9F 
A6000000° 9F 
G8000000°9F 


G8008000°EF 


G8BC8A80" 9F 


GA600000°9F 
28000080° 9F 


68AB98dO 
2220 
BUBA*° CF Da 
QAOSAO0G°EF TF 
80 DD 
8B DO 
UBOGKUVU00°EF 0D 
04 F8 
62 0@ 
CA000000°EF 7F 
a2 DD 
87 DO 
O0BA0000°EF DD 
a4 FB 
15 El 

4) 
a2 DD 
FEOS CF OF 
8800°CF OD 
01 DD 
Q@4 FB 
BACSIARB°EF DD 
61 FB 
OF AF FA 
018B 31 
11 E4 

2c 
"14 DD 
FEBF CF DF 
@200°CF OD 
Be DO 
a4 FB 
O60GA008°EF DO 
al FB 
FF6B CF FA 
9157 31 


UYFE 
UGFE 
Vive 
ALR?) 
B14 
4169 
vV1OF 
9111 
Yv113 
i119 
“120 
B123 


0123 
A129 
2128 
ut2d 
0133 
AL3A 
144 
vide 
Ci4de 
“W1a4g 
4148 
Gide 
G14E 
Yi4E 
4155 
0158 
A162 
O16A 
160 
0160 
W174 
0175 
A175 
0177 
6178 
vAL7F 
wisi 
¥181 
Y188 
W188 
BW1B8E 
4195 
6195 
VI9OE 
VI9E 


136 


148 
189 


11@ 


117 
118 


12” 
121 


DATA, 4013 
~LONG 9 ; TEST ARGUMENT TABLE TERMINATOR 
TEST, 88133 
~WORD 3 = “Med 3 ENTRY MASK 
1083 MOVL K“BASE,ADDRESS,R2 3 GET DRIVE*S ADDRESS 
PUSHAQ CH,STATUS 
PUSHL #9 
PUSHL #CHCS_INITA 
PUSHL RIVE 
CALLS #4, @#DSSCHANNEL 
MOVL RPCS1(R2),R3 3 GET CONTROL/STATUS 
SOS,CHANNEL,S DRIVE, #CHCS, STATUS, »CH,STATUS 
PUSHAQ CK STATUS 
PUSHL #0 
PUSHL #&CHCS,STATUS 
PUSHL DRIVE 
CALLS 44, @#DSSCHANNEL 
BBC #CHSSV,MBACPE, CH,STATUS, 20S » CHECK FOR CONTROL 8US8 
ys PARITY ERROR 
PUSHL #2 
PUSHAL W°MSG,MCPE 
PUSHL W°DRIVE 
PUSHL 4#SER 
333 TEST 1, SUBTEST @, ERROR j 
CALLS  #3$5M, @#DSSERRHARD 
PUSHL DRIVE 
CALLS #1, @#DSSSHOCHAN 
CALLG 188, e#DSSCKLOOP 
BRW TEST,901,% 3; EXIT TEST 1 


‘BS SESRSSSSESESESEESLLSALI SSE SESS ESS ELE SSS ESSE SRR E RES ERLE SEE CREE a ES 


eos3 BBC #CHSSV,MBANED, CH STATUS, 25$ 3 CHECK FOR NON@EXIST, ORIVE 
SDS,ERRHARD,S eW*DRIVE,W"MSGLNED 
PUSHL #U 
PUSHAL W*MSG,NED 
PUSHL W*ORIVE 
PUSHL #$ER 
333 TEST 1, SUBTEST 8, ERROR 2 
CALLS #S$$M, @#DSSERRHARD 
SOS,SHOCHAN,S DRIVE 
PUSHL ORIVE 
CALLS #1, @#DOSSSHOCHAN 
$D3 ,CKLOOP 10$ 
CALLG 1u$, @##D0SSCKLOOP 
$OS,EXIT TEST 
BRW TEST, 001,X 3 ‘EXIT TEST 1 


TK-1124 


Figure 5-11 ESRCA RP@X/DCL 
Test 1, Subtest @, 
Program Listing 
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DIAGNOSTIC SUPERVISOR 


START 


DISPATCH 


ESRCA 
RPOX/DCL REPAIR 
TEST |, SUBTEST O 


GET ADDRESS 
OF DRIVE 
UNDER TEST 


ENTRY MODULE ROUTINE 


CHANNEL MODULE 


| BLDCDB ROUTINE. | | DS$ CHANNEL | Or) 


GET HARDWARE GET CALL 
P-TABLE UNIT # ave eaia 


ERROR 


BUILD CHANNEL 
DATA BLOCK 


INDICATE 
SUCCESS 


GET STATUS 
OF DEVICE CHAN, 
SYSTEM 


SET MBA 
INIT 


| 
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Figure 5-12 ESRCA RP@X/DCL Repair Diagnostic Test 1, Subtest @, 
Flowchart (Sheet 1 of 2) 
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DIAGNOSTIC SUPERVISOR 


DSSERRHARD 


(PRINT ERROR 
=< St 


DSS$SHOCHAN 
(SHOW MBA 
REGISTERS) 


DS$CKLOOP 


(LOOP IF LOOP 
a a 


DISPATCH 
ROUTINE 
(CALL NEXT TEST) 


Figure 5-12 


ERROR 1 YES 


ESRCA 
RPOX/DCL REPAIR 
TEST |, SUBTEST O 


READ RPCS1 
OF DRIVE 


CALL 
DS$ CHANNEL 
(STATUS) 


CONTROL 
BUS PARITY 
ERROR 


NON- 
EXISTENT 
DRIVE 


ERROR 2 
YES 


NO 


AND SO ON 


TK-0748 


ESRCA RP@X/DCL Repair Diagnostic Test 1, Subtest 9, 


Flowchart (Sheet 2 of 2) 
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P-Table address, and the adapter address; clears the flag word; 
and determines whether the channel iS an MBA or a UBA. When 
control returns to the DSXSCHANNEL routine, the function argument 
passed from the calling program (ESRCA) is evaluated, activating 
one of several function subroutines. In this case, the INITA 
Subroutine sets the initialization bit in the MBA control 
register. 


Control then returns to the calling program (ESRCA), which reads 
the RPCS1 (control status) register of the unit under test with a 
MOVE instruction (direct I/0). The test routine then calls 
DSSCHANNEL again, this time passing a different function argument 
(CHCS STATUS). The DSXSCHANNEL routine is executed again, 
activating the CHCS STATUS subroutine which stores the unit and 
adapter status in the location labeled CH STATUS. 


Then when control returns from the DSXSCHANNEL routine to the test 
routine, the data in location CH STATUS is compared, bit by bit, 
with expected data patterns. If an error is detected, the test 
routine calls a series of supervisor routines (DSSERRHARD, 
DSSSHOCHAN, DSSCKLOOP, and DISPATCH) to print out error 
information, loop if the loop flag is set, and return to the 
dispatch routine if the loop flag is not Set. 


Se leZ RP@X/DCL Repair Diagnostic Sample Error Message 

Test 1, subtest @, error 1 of the RP@X/DCL diagnostic identifies 
control bus parity failures on the Massbus (Figure 5-11). When the 
program detects this failure, the error message identifies the 
failure by test, subtest, error, failing unit, and error type. In 
addition, the message includes an MBA channel status dump, showing 
the contents of the pertinent registers, as shown in Figure 5-13. 


Bit 17 of the status register is set, indicating the Massbus 
control parity error. 


Other error message formats display expected and received data and 
the contents of relevant registers in the RP@X/DCL, depending on 
the error and the failing test. 


5.8 DISK RELIABILITY DIAGNOSTIC (QUEUE I/0), SAMPLE SUBTEST 


5.8.1 Detailed Flow 

The Disk Reliability Diagnostic program (ESRAA) is representative 
of the queue I/0 diagnostics. Instead of performing move 
instructions to read and write peripheral device registers 
directly (as the MBA diagnostic does), the program builds an 
argument list containing device and transfer parameters and 
pointing to the data to be transferred and the function to be 
performed. The program then calls the queue I/O services of VMS or 
the diagnostic supervisor. In this way, the program transfers 
information to and from the peripheral device under test without 
requiring exclusive use of the device, the channel, or the 
computer system. Figure 5-14 shows the listing for ESRAA test l, 
subtest @, error 12, the first of the data transfer tests. Figure 
5-15 shows the program flow for the same routine. 
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** PROGRAM: ZZ-ESRCA RP@X/DCL DIAGNOSTIC, REV 4.1, 46 TESTS. 


TEST 1: QUALIFICATION TESTS 

RRKKKEEK ZZ-ESRCA RP@X/DCL DIAGNOSTIC - 4.1 BB ON 

PASS 1 TEST 1 SUBTEST @ ERROR 2 1@8-MAR-1978 98:26:20.26 

DEVICE FATAL WHILE TESTING DBA: CONTROL BUS PARITY ERROR DETECTED 


MBA CHANNEL STATUS DUMP 


MBA_CSR: [29610996] 90000020 (X); 

MBA_CR: [29919904] ADOOGOBS (X); 

MBA_SR: [20816008] DBO2GOGOH(X); MCPE 
MBA_VAR: [2661989 0C] GOBGS200 (X); 
MBA_MAP(8Q) : OOOOBBOOH(X); 

MBA_BCNT: [26919816] BHGOOODD (X); 
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Figure 5-13 ESRCA Sample Error Message 
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ZZ"ESRAAWS,2 


DATA TRANSFER TESTS 

Ser raonaeel® QUALIFICATION TESTS ZZ=ESRAAH5,2 
) 
e 


DATA TRANSFER TESTS 
wZ4s 
ABS 
e3as 
30g 
'34S5 
{9395 
O3a5 
2BAS 
P3ZAS 
W335 
P3435 
¥3v5S 
azZAsS 
A385 
W3A5 
Q3U5 
W385 
“325 
A305 
@3a5 
93a5 
AZAS 
55 QA AB 3C «63385 
S56 ag AB 9A V3a9d 
57 2& AB 94 6320 
@S AB @0°8F 91 w3it 
ae 12 316 
BA %%318 
G0900001 °EF AGIF BF A319 
v9 11 32) 
BQO A323 
GB00nnu1°EF 1215 8F 4324 
52 04 &32C 
BOCGAGAB4TEFYA ASTAAS7TA BF D@ w32E 
5a BOAAGATE BF F3 334 
EC C341 
58 0&4 W342 
SA 04 «a344a 
56 Qi C3 13346 
59 “349 
54 A2ACAAUAQ* EFL NA w34a4 
1¢ Ad “UNM OAUBY EF DE 352 
28 Aw YAZOV2AD BF 0@ 335A 
ABwVAUP CY 59 90 %%362 
AAAB*CY SA 9A 367 
auaa’ca 58 BA ~236C 
36 AG AAUAAAGAPEFU? 0A 7371 
V-37A4 
AB AY ANABAUAATEFUS DS t37A 
98 A383 
ac Ad @B 384 
°387 
GOAB8GA0° OF 6E FA e387 
J38E 
AQQUGAGA°GF 64 FA 238E 
aR 63 EB W395 
0398 
S2 DD 2398 
7E 55 BQ w39A 
7E 59 99 azgN 
7E SA 9Q@ w3ae 
BOAAAAAZ°EF a2 FB 33A3 
03 Sa E9 ASAA 
0178 31 ean 
“w3RA 
OAGAARYD? OF 6E FA ‘384A 
AZB7 
BBQVEP4UN*YGF 64 FA 387 
22 63 ES wee 
33C1 
“3c 
AAAAPAARTEF DF v¥3C1 
AAAAAGAA EF OF 33C7 
52 DD w3C0 
gc DO w3CF 
304 
OPOUBANA? OF vu FR “7301 
“308 
QBWVVAQAGIAS IF DS AF FA A308 
AIGA 31 wtyen 
P3E3 
BUSGVHVE° OF CA AF FA vw3E3 


Figure 5-14 
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3a9 
314 
3il 
312 
313 
314 
315 
316 
317 
316 
319 
32a 
321 
322 
323 
324 
325 
326 
327 
328 
329 
338 
331 
332 
333 
334 
335 
336 
337 
338 
339 
34¢ 
341 
342 
343 


344 
345 
346 


347 
348 
349 
35¢ 
351 
352 
353 
354 
355 
356 
357 
358 


359 


368 
361 


362 
363 
364 


365 
366 


367 
368 


369 


374 
371 


Fiche 1 Frame 016 Sequence 198 
31-AUGe{978) «610252244 VAXe14 MACRO X0,32e6 Page as 
S++ 
s BEGIN MULTIeSECTOR WRITES, WRITECHECK, AND READS 
s REGISTERS USAGE: 
¢ RS s MAXIMUM NUMBER OF CYLINDERS 
* R6 s MAXIMUM NUMBER OF TRACKS 
6 
: R7 © MAXIMUM NUMBER OF SECTORS 
eo 
s RB & CURRENT CYLINDER NUMBER 
: RO ws CURRENT TRACK NUMBER 
s R10 = CURRENT SECTOR NUMBER 
3 
3 Ril = DEVICE CHARACTERISTICS POINTER 
jee 
MOVZWL OSKOCSW CYLNOR(R11),R5 3 PICK UP MAXIMUM NO OF CYLINDERS 
MOVZBL OSKOCER, TRACK(R11),R6 3 PICK UP MAXIMUM NUMBER OF TRACKS 
MOVZBL OSKOCSBASECTOR(R11),R7 3 PICK UP MAXIMUM NUMBER OF SECTORS 
CMPR ¥RMAZ,OSKOCSBLTYPECRI1) 3 IS THIS AN RMO3? 
BNEO 141$ 3 NOPE 
MOVW #LSTSECT,RM,e : GET LAST SECTOR IN CYLINDER 
LAST$w,SECTOR 3 
BRB 1828 3 SKIP 
18188 MOVW SLSTSECT RP,= 3 LAST SECTOR FOR RP 
LASTSW,SECTOR ; 
18283 CLRL RU s CLEAR LONG WORD BUFFER INDEX 
19083 MOVL ¥PATTERNI, BUFFER] (RQ) ¢ WRITE PATTERN 
AOBLEO #127,Ra,1988 s WRITE Si2 BYTES 
CLRL R8 : CLEAR CURRENT CYLINDER 
CLRL R1i@ 3 CLEAR CURRENT SECTOR 
SUBL3 #1,86,R9 3 BEGIN AT LAST TRACK 
MOVL QIOPTRLIST(R2),R4 : R&@ POINTS TC QIO ARGLIST 
20a$3 MOVAL BUFFERY,QIO8 PI (R4) 3 PUT BUFFER ADDRESS IN Q@YO ARGLIST 
MOVL 8512,QT08,P2(R4) ; WRITE BYTE COUNT 
MOVB RO, QIO$SB, TRACK(RG) s WRITE TRACK VALUE 
MOVB R14,QIO0$B,SECTOR(RG) 3 WRITE SECTOR COUNT 
MOVW R@,QIOSW_CYLNOR(RG) : WRITE CYLINDER 
MOVL OSKDBLPTRLIST(R2),¢ : WRITE OJAGNOSTIC BUFFER ADDRESS 
QTOS ,PECR4) 
MOVL EF, LIST(R2),QIOS,EFNC(R&Y) 3 WRITE EVENT FLAG NUMBER 
MOVB #IQE ,WRITEPBLK,&= s SET FUNCTION & WRITE 
QIOS,FUNC(R4) 
ENS BREAK ¢ CHECK FOR °C 
CALLG (SP), #s0SS$BREAK 
$QIOKLG (RU) s ISSUE QIO REQUEST 
CALLG (R4),G*SYSSOIOW 
BLBS (R3),2198 3 BRANCH IF NO ERRRORS 
CHECK, BLOCKS R2,R8,R9,R1O s CHECK BAD BLOCK FILE 
PUSHL Re 
MOVw RB,~-(SP) 
MOVeB R9,e(SP) 
MOVB R10,°(S§P) 
CALLS #2, CHECK, BLOCK 
RALBC RA,295§ 3 BRANCH IF NOT IN BAD BLOCK FILE 
BRw bubs s GET NEXT BLOCK 
20588 SOS, BREAK 3 CHECK FOR *C 
CALLG (SP), #@#DSSBREAK 


ss: TEST 1, 


21Ass 


Disk Reliability 


(ESRAA) Test 1, Subtest @, 
Error 12 Listing 


€QIOW,G CR4) 


; RETRY WRITE COMMAND 


CALLG (R4),G*SYSSQION 
BLAS (R3),210$ + BRANCH IF SUCCESS 
SOS,ERRHARD,S  ,R2,BLANK,= ; REPORT ERROR 
; 


PUMP STATIS 


DUMP STATUS 


PUSHAL DUMP_STATUS 


PUSHAL 
PUSHL 
PUSHL 
SUBTEST @, 
CALLS 


$DS,CKLOOP 


CALLG 


RRwW 64S 
SOS, CKLOOP 


CALLG 


BLANK 
Re 
A#$ER 
ERROR 12 

#$$M, @#DSSERRHARD 
2a58 
eases, 


+ LOOP 
e#DS$CKLOOP 
3 GET NEXT BLOCK 
215% 


205$, ##0S$CKLOOP 
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VMS 


DISK RELIABILITY ESRAA TEST 1, 


AND SUBTEST O, (ERROR 12) DATA TRANSFER TESTS 
DIAGNOSTIC 
SET POINTERS 


TO CYLINDER O 


SECTOR O 
DETERMINE NUMBER LAST TRACK 


OF CYLINDERS 
rencns ey 


DETERMINE DRIVE ARGUMENT LIST 


TYPE BUFFER ADDRESS 
BYTE COUNT 
TRACK SECTOR 
CYLINDER 
DIAGNOSTIC BUFFER 
ADDRESS 
EVENT FLAG # 
FUNC = WRITE 


WRITE PATTERN 1 
(A570A570) 

INTO A BUFFER 
512 BYTES 


COMMAND eee 
LINE 
INTERPRETER 
QI/O SERVICES NO 
WRITE PATTERN 1 TO 
FIRST CYLINDER ISSUE 
FIRST BLOCK LAST Q 1/0 
TRACK REQUEST 
LOAD DIAGNOSTIC 
BUFFER 
LOAD I/O STATUS 
BLOCK (IOSB) 
ISOB 
SUCCESS YES eeecae 
2 | NORMAL 
NO 
| FAILURE 
i? 
CONTINUE WITH 
NEXT PART 
OF TEST 1 
| (READ PATTERN 
JUST WRITTEN) 


TK-0582 


Figure 5-15 ESRAA Test 1, Subtest @, Error 12 Flowchart 
(Sheet 1 of 3) 
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VMS ESRAA DISK RELIABILITY 
AND ty 
DIAGNOSTIC 
ROUTINE 
[Ger ear 
SECTOR 
ROUTINE 


READ 
BAD BLOCK 


7 
! 
| 
| 
| 
| 
| 


BEEN READ 


GET (NEXT) 
COMMAND YES | WORD FROM one = 
LINE BAD BLOCK COUNTER 
INTERPRETER | | FILE 
Bue | otter 
Q 1/0 REQUEST | BAD BLOCK 
Q 1/0 SERVICES | eT ENe 
WRITE PATTERN 1 J 
LOAD 10SB 
AND DIAG BUFFER | | ) 
NO OSB OF CYLINDER BAD BLOCK 
CONTENTS | TRACK SECTOR | FILE IS 
NORMAL a WITH ITEM FROM OK 
DS$ERRHARD OS Ee 
DUMP STATUS YES 
PRINT ERROR MSG | g in a Ne ee a ee 


DSS$CKLOOP | 
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Figure 5-15 ESRAA Test l, 
Subtest @, Error 12 Flowchart 
(Sheet 2 of 3) 
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VMS AND DIAGNOSTIC 
SUPERVISOR 


ESRAA 
DISK RELIABILITY 


SET POINTERS 
FOR NEXT 
BLOCK 


YES RP 
D 


RIVE 
TYPE 
STATUS DUMP NO 


PRINT 
COMPLETION 
TIME 


| YES 
COMMAND 
YE 
LINE 2 
INTERPRETER 
NO 


DISPATCH 
ROUTINE 


TK-0584 


Figure 5-15 ESRAA Test 1, Subtest @, Error 12 Flowchart 
(Sheet 3 of 3) 
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The first test, when it is called by the dispatch routine in the 
Supervisor, setS up a pointer to the I/O status block and tests 
various drive commands (drive clear, seek, recalibrate, NOP, 
offset, and reset). Test 1 then performs an oscillating seek test 
before beginning the data transfer tests. 


In the data transfer tests portion of test 1, the program sets up 
a write transfer of a data pattern (A579@A57@) to the first block 
on the disk pack in the drive under test. The data to be written 
to the disk is loaded into a buffer area in memory. The program 
then builds an argument list containing the address of the data 
buffer, the byte count of the data to be transferred, the location 
of the target block on the disk pack (track, sector, cylinder), 
the diagnostic buffer address, the event flag number, and the 
function to be performed. Then, after checking for Control C, the 
program calls SYSSQIOW. 


If the program is being run in the user mode (VMS environment), 
the call to SYSSQIOW invokes a routine in VMS. If the program is 
being run in the standalone mode, the SYSSQIOW call invokes a 
Similar routine in the Supervisor. SYSSQIOW builds an I/O packet 
from the parameters passed from the diagnostic program and then 
(if in VMS) checks the privilege of the calling process (the 
diagnostic supervisor) through internal data structures. The 
SYSSQIOW routine then places the packet in a queue for processing 
by a device driven routine, clears the event flag, and waits for 
completion of the 1/0 function (indicated by the setting of the 
event flag). When the driver completes the I/O function, it 
examines the controller and drive status registers, formulates a 
Status message that is stored in the I/O packet, and loads the 
diagnostic buffer with drive and adapter register contents. The 
I/O packet is then inserted into the I/O post queue and a software 
interrupt to initiate I/O post processing is requested. The I/0 
post routine performs final I/0 request processing and status 
posting (IOSB), loads the diagnostic buffer with device and 
adapter (on MBA or UBA) register contents, and sets the event 
flag. 


With the event flag set, the calling program (ESRAA) resumes 
control. The diagnostic program then checks the I/O Status Block 
(IOSB) to determine whether or not the requested function was 
completed successfully. The IOSB has the format shown in Figure 
5-16. 


31 16 15 00 


BYTE COUNT STATUS 
THEHEHEHEFEFNSSeeeeeeaesSsS=$Ss 


DEVICE-DEPENDENT DATA 
TK-0743 


Figure 5-16 I/0 Status Block Contents (for disks) 
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If the low order bit of the first longword of the IOSB is set, 
indicating success, the program does a branch to the next portion 
of the test (label 210$), where it tests the loop flag and then 
reads the data just written to the disk pack. 


If the low order bit of the IOSB is not set, the test calls the 
CHECKBLOCK routine (refer to the code in Figure 5-17), which is 
located in the load blocks module (module 6) of the disk 
reliability program (refer to the link map). This routine, in 
turn, calls the GETBBFSECTOR routine (Figure 5-18) which reads the 
load block sector on the disk pack. If the load block file cannot 
be read at all, the routine returns control to test 1, where the 
queue I/O request is retried. If the load block file has been read 
successfully, the routine checks through the item in the file to 
see if the address of the block which cannot be written to is 
already noted in the load block file. I£ so, the load block file 
is OK, and control returns to test 1, which setsS up pointer to 
access the next block on the disk, builds a new queue I/O argument 
list, and again calls SYSSQIOW, as previously explained, in an 
attempt to write the pattern into the next block on the disk. 


If the failing block address is not listed in the load block file, 
the CHECKBLOCK routine returns control to test 1 which, in turn, 
issues a second queue I/O request (after checking for Control C). 
If the request fails again (IOSB status code = @), the program 
calls the DSSERRHARD routine in the supervisor, which dumps the 
Status block and diagnostic buffer contents and other error 
information. After detecting a failure of this type, the program 
checks the loop flag. If the loop flag is set, the program repeats 
the queue I/O request indefinitely. Otherwise, the program checks 
each block on the disk pack until it finds one that it can write 
into successfully, before going on to check the next function 
(read the block just written, beginning at label 2190$). 
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ZZ>ESRAAS,2 
ESRAA6,MAP_BB 
5,4 


QAAQAAANwT OF 
18 


QYUAOBKAG? OF 


400020000° 9F 
Se 
53 
54 
55 


57 
58 


BSAABPCA°EF 
OA 
$6 


56 


S6 


OQ9AAACa°EF 
uy 
57 
590 
58 


54 


a8 
52 


@a 
53 


ASCAAABUA® OF 
52 


57 


56 
W8 AB 


BAD BLOCK FILE ROUTINES 


Aa 
Ba 


2ALARAAZA°EF 


| 
@4 
50 


BQ 


AGAAAAAGSEF 


88 AC 
a1 


Qu 


6C 
64 ac 
@5 Ac 
@6 AC 
48 AC 
56 


G2 
VAZAUAAGS EFS 


55 
56 
Q2 
S¢ 
a8 
64 
a2 
E8 


ag 
11 
55 
56 
A2 
Sa 
Qe 


ABABAASATF FUT 


FFFF 8F 
31 
5@ 
24 
12 
Su 
10 
18 
5a 
16 


QD 


JASACAS AEF 


ABABAATE BF 


Figure 5-17 
Routine Code 
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MAP RAD BLOCKS ZZ=ESRAACS5,9 
BAD BLOCK FILE ROUTINES 


ABANNVAGO 144 
YUIG 145 
AFFC "gaa 146 
eave 147 
DD Ad%e2 
00 tyvad 
JF AA 
DDB #8AC 
FR (tue 
E& gA1S 148 
Gala 149 
DD A18 
OF ALA 
DD weaeAa 
0D 423 
M925 
FB A25 
492C 15@ 
FA Nv2C 
9A 4033 151 
QA AA37 152 
3C) =— BARB 153 
08 OTF 154 
04 yas 155 
9A WadS 156 
7D UadgA 157 
“asin 158 
ND wesa 159 
0D 22852 16a 
FB ans4 161 
EB weSB 162 
91 MUSE 163 
13 261 164 
CA 63 165 
11 66 166 
PV6B 167 
9A FAGB 168 
11 '”6R 169 
0D 460 17a 
0D ehOF 171 
FB A774 i172 
E9 ¥¢78 173 
9A WAT7R 174 
DA wve7E 175 
R{ ¥086 176 
13° vvsA 177 
Bi v¥gAD 178 
12 *#aguv 179 
ED vwv92 180 
AQQS 
12 ¥897 141 
EO ¥4”99 1&2 
229C 
12 age 183 
wAAQ 184 
0D veAA 
7F vabe 
0D AHAB 
FBR waba 
9A sABI 185 
11 «“aB4 186 
F3 WABE 187 
weBN 
CO siCRKE 188 
91 wACci 189 
19 £9Cs 19a 
¥OC7 191 
04 wAACT 192 
4AC9 193 
AG 49C9 194 
SICA 195 
SIAC A 196 
NACA 197 
“ACA 198 
CHECKBLOCK 


ePSECT 


CONES 


CHECK, BLOCK?? 


31"AUG=1978 


Fiche 1 Frame L113 Seauence 167 
14351331 VAXe11 MACRO X8,3"6 Page 5 
(3) 


e’ORD “MECRO,R3,RO,PR5,RO,R7,RB,-RO,RIG,RII> 
SOS GETBUF_S #1,BBF POINTER 3; ALLOCATE BUFFER 
PUSHL #0 
PUSHL #0 
PUSHAQ BRF,POINTER 
PUSHL #4 
CALLS #4, @XDSSGETBUF 
BLAS RA, 2$ : SUCCESS? 
SDS,ERRSYS,S e@LUNCAP),MSG,NOMEM 
PUSHL #0 
PUSHAL MSG,NOMEM 
PUSHL LUNCAP) 
PUSHL #SER 
s39 TEST 9, SUBTEST 9%, ERROR 1 
CALLS H#ESM, @RDOSSERRSYS 
SDS,ABORT 
CALLG (AP), @#DSSABORT 
2s MOVZBL SECTOR(AP),R2 ? PICK UP SECTOR 
MOVZBL TRACKCAP),R3 : PICK UP TRACK 
MOVZWL CYLINDER(CAP),RY : PICK UP CYLINDER 
MOVL LUNCAP),RS 3 PICK UP LOGICAL UNIT NUMBER 
CLRL R6 3 CLEAR SECTOR COUNTER 
MOVZBL #2,R7 3 INITIALIZE INDEX OFFSET 
MOVQ OSKNC ,OWDLIST+4(R5]),R& 3 PICK UP ADDRESS OF DRIVE CHARACTERISTICS 
17$3 
PUSHL RS 3 PUSH LUN 
PUSHL R6 s PUSH SECTOR 
CALLS #2,GETBRF, SECTOR s READ BAD BLOCK SECTOR 
BLBS RA,SCAN 3 BRANCH IF SUCCESS 
CMPB 48,P6 ¢ HAVE FIRST FIVE SECTORS BEEN READ? 
BEOL CHECK BLOCKZX 3 TAKE FAILURE EXIT 
ADOL #2,R6 3 AOO 2 TO SECTOR COUNTER 
BRB 10$ s CONTINUE READING 
SCAN? 
MOVZBL #8,R6 s INITIALIZE SECTOR COUNTER 
BRB 2a$s 3 CHECK BLOCK READ FROM PREVIOUS LOOP 
1@$¢3 PUSHL RS ; PUSH LUN 
PUSHL R6 : PUSH SECTOR NUMBER 
CALLS #2,GETBRF SECTOR : READ NEXT SECTOR 
BLBC R2,40$ ¢ IF FAILURE TRY NEXT BLOCK 
MOVZBL #2,R7 s IGNORE FIRST TWO LONG WORDS OF THE FILE 
20s: MOVL @BBF POINTER(R7),R@ 3 PICK UP BAD BLOCK FILE ITEM 
CMPW #o1,RA 3 CHECK FOR END OF BAD BLOCK FILE 
BEQL uas : IF EOF TRY NEXT SECTOR 
CMPW Ra,Rd 3 IF CYLINDERS DON*T MATCH 
BNEQ 3a$ s THEN BRANCH 
CMPZV #16,#8,RO0,R2 : IF SECTORS DON’T MATCH 
BNEO 3a$ : THEN BRANCH 
CMPZV #24,48,R0,R3 : IF TRACKS DON°T MATCH 
BNEQ 30% s THEN BRANCH 
SOS, RELBUF,S #1,B8F POINTER 
PUSHL #0 
PUSHAQ BBF_POINTER 
PUSHL #1 
CALLS #3, @DSSRELBUF 
MOVZBL #41,R9 s INDICATE SUCCESS 
BRB CHECK _BLOCKx 3 AND EXIT 
3a$3 AQBLEQ #127,R7,2a$ : IF ALL BLOCKS NOT CHECKED INDEX AND LOOP 
GA$s ADDL #2,R6 : BUMP SECTOR COUNTER BY TWO 
CMPB Ro,OSKDCSEB,SECTOR(RB) ¢ CHECK FOR LAST SECTOR 
BLSS 12$ ¢ CONTINUE READING IF NOT LAST SECTOR 
CHECK BLOCKZX3 
CLRL RA : ELSE INOICATE FAILURE 
CHECK, BLOCKX3 
RET : EXIT 


eSBTTL GETBRF SECTOR ROUTINE 
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S2 
53 
54 


@400°C4 


ee8aa°C4 
ic A4 
BABa°C4H 
20 Ad 
Qu AY 


9B Aa 
@C Ad 
@c Ad 
1@ AY 


G8AAAUN0" GF 


28 AC 
CAvauvOU4EF4S 
ABAAABBOR°EF 


YA AZ 

OOCHlV3IA°EF 

QA AC 

A2AD BF 
A2UURALAAP EF YS 
HAAACADAPEF4? 

28 AQ 

Gc 

ADAAAVBAD BF 
YOvaugane°EFue 

55 


64 


BO7C 
oe 
70 
DE 
83 


A3 


Wh) 
98 
3c 
DA 
08 
da 
D2 
C8 
7E 
DG 


FA 
a4 


VOCA 
GQaCA 
SACC 
GADA 
@ND8 
DODF 
WOE 1 
YAE6 
HUE8 
WwAEN 
“WAFS 
AAFR 
124 
W12A 
ile 
@117 
w118B 
123 
“128 
ULOF 
tier 
vi1l36 
“137 


268 GETBBF,SECTORS:: 


269 
272 
271 
272 
273 
274 
275 
276 
277 
278 
279 
282 
ro | 
282 
283 
284 
285 
286 
287 


228 
289 


eSBTITL 


«WORD 
MOVL 
MOVQ 
MOVAL 
SUBB3 


SUBW3 


MOVL 
MOVB 
MOVZWL 
MOVL 
MOVL 
MOVL 
MOVL 
BISL 
MOVAQ 
MOVL 
SOIOW,G 


RET 


“M€R2,R3,R4,R5S,RO> 

LUNCAP),R2 : PICK UP THE LOGICAL UNIT NUMBER 
OSKOC_LQWOLIST+4[(R2]),R3 3 PICK UP POINTER YO DRIVE CHARACTERISTICS 
ARGLIST,ARG 7 RY <em POINTER TO LOCAL QI0 ARGLIST 
#1,0SKDCSB_, TRACK(R3),@ 

QTO$B, TRACK(R4) 3; WRITE TRACK TO READ 
#1,0SKOCESW_CYLNOR(R3),@ 

OTOSWCYLNDR(R4) ; WRITE CYLINDER TO READ 


BBF_LPOINTER, QIOS,P1(R4) 3 WRITE BUFFER ADDRESS INTO @T0 ARGLIST 
SECTORCAP),-QIOSB,SECTORCR4) 3 WRITE SECTOR TO READ IN GIO ARGLISY 
#512,QT0$,PecRa) ; WRITE BYTE COUNT 
EF,LIST(R2],GIOS,EFN(R4) 3» WRITE EVENT FLAG 

QIOPTRLIST(R2],RA : PICK UP Q@YO PTR 

QIO$S _CHANC RO) ,QIO$_ _CHAN(R4) s WRITE ASSIGNED CHANNEL 
#IOS,REAOPBLK,QIOS,FUNC(RG) 3» WRITE READ PHYSICAL FUNCTION CODE 
#IOSM,INHERLOG,GIOS,FUNCCRG) 3 INHIBIT ERROR LOG 

IOSTATUS, BLOCK [R2),R5S 3 PICK UP IOSB8 ADDRESS 


R5,OINS,IOSB(R4) s WRITE I08B ADORESS INTO QIO ARGLIST 
(RG) 3 ISSUE QI0 REQUEST 
CALLG (R4&),G*SYSSQIOW 

¢ EXIT 


PUT, BADBLK ROUTINE 


TK-1125 


Figure 5-18 GETBBFSECTOR 
Routine Code 
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5.8.2 Disk Reliability Program Sample Error Message 

Test 1, Subtest @, Error 12 of the disk reliability program 
identifies bad blocks, on the disk pack under test, that are not 
entered in the bad block file. The message shown in Figure 5-19 
identifies the failing test, subtest, and error numbers. The 
message also includes a dump of the channel registers (MBA 
registers in this case) and the RM@3 registers. 


Notice that bits 12 and 15 of the RMER] register are set, 
indicating a data check error. The starting cylinder is @. The bad 
block is located in sector 1, on track 4, as shown by the contents 
of the RMDA registers. 


TEST 1: QUALIFICATION TEST 
DRA1 QA BEGUN AT 2-FEB-1979 14: 26:18.54 
Raa KKKEE VAX DISK RELIABILITY TESTS ** ESRAA ** -- 5.2 ERER AAAS 
PASS 1 TEST 1 SUBTEST @® ERROR 12 2-FEB-1977 14: 26:26.52 
HARD ERROR WHILE TESTING DRAI: 


FUNCTION INITIATION SUMMARY: 

FUNCTION ATTEMPTED: WRITE DATA 

BUFFER ADDRESS RANGE: FROM: 98080388 TO: 88000587 
ATTEMPTING BYTE COUNT WAS: 512 

STARTING DISK ADDRESS: 

CYLINDER: 9 TRACK: 4 SECTOR: @ 

FUNCTION ABORT SUMMARY: 


UNDEFINED SYSTEM STATUS VALUE = 889080008 


MBACSR : 089808020 ; ADAPTER CODE = 26 (X) 

MBACR : 98000004 ; IE 

MBASR : GBB802600 ; DT COMP 

MBAVAR : 990908388 ; MAP POINTER = @1(X), PAGE BYTE ADDRESS = 188 (X) 
MBABCR : 880800 00 ; MASSBUS BYTE COUNT = 6000 (X), SBI BYTE COUNT = 98088 (X) 
MBAFMAP _ : 8B8BG00E7 ; BIT 31, BIT 7, BIT 6, BIT 5, BIT 2, BIT 1, BIT B@ 
MBAPMAP — : 80000 0F2 ; BIT 31, BIT 7, BIT 6, BIT 5, BIT 4, BIT 1 

RMCS 1 : 08390 ; DVA, FUNCTION = WRITE DATA 

RMDS 3 11C@ ; MOL, DPR, DRY, VV 

RMER 1] : 8800 ; DCK 

RMMR : 89 28 ; MWR, MSCLK 

RMAS : 8900 ; 

RMDA : 8401 ; TRACK = @4(D), SECTOR = 6@1(D) 

RMDT : 2814 ; MOH, DRQ, DRIVE TYPE = RM@3 

RMLA 3 8040 ; SECTOR = @1(D) 

RMSN : 88 46 ; SERIAL NUMBER = 8846 (X) 

RMOF : 1860 ; FMT22, ECCI 

RM DC : 88 BO ; DESIRED CYLINDER = 880606 (D) 

RMHR $ 8008 ; 

RMMR 2 : 13FF ; CNT/CYL, BUS IN LINES = 1FF(X) 

RMER2 : 09 00 ; 

RMEC] : 0836 ; BURST LOCATION = 9836 (X) 

RMEC2 3 8900 ; ERROR BURST = 08090 (X) 
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Figure 5-19 ESRAA 
Sample Error Listing 
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CHAPTER 6 
CPU CLUSTER EXERCISER PACKAGE 


The CPU cluster exerciser package consists of three separate 
programs (ESKAX, ESKAY, ESKAZ). Two modules, the control module 
and the common instruction test services module (CITS), are common 
to all three programs. ESKAX, the first program, is the quick 
verify portion of the cluster exerciser package. This program 
includes the compatibility mode entry and exit test, the first 
part done test, and the SBI exerciser. The second program, ESKAY, 
contains the timer and clock tests and the native mode instruction 
set tests. ESKAZ contains the memory management test and the 
compatibility mode instruction set tests. Figure 6-1 iS a map 
showing the memory allocations of the three programs. 


The cluster exerciser diagnostics will handle three classes of 
errors, providing three corresponding types of error messages: 
unexpected exceptions or interrupts; test failures; and _ safe 
return halts (resulting from fatal errors). The code for the 
cluster exerciser programs iS not as easy to follow as the code 
for other diagnostic programs. However, the error messages which 
the programs generate are detailed and, for the most part, 
self-explanatory. The operator should understand the general 
Structure of each test and the error message formats in order to 
use all of the facilities provided by the cluster exerciser 
programs. 


6.1 CONTROL MODULE 

The control module in the cluster exerciser programs serves as the 
interface between the programs and the diagnostic supervisor. The 
module performs the following functions: 


. Program initialization and clean up 
Execution of all tests twice in one pass 


- Print out of a module summary mesSage at the end of each 
pass, if errors exist 


Initialization and reinitialization of pertinent control 
variables 


Set up of all vectors for interrupt and exception 
handling 


Proper fielding of all exceptions and interrupts 
(expected and unexpected). 


When the control module detects an unexpected interrupt or 
exception, it prints out an error message as shown in Example 6-1. 


ESKAZ 
(MEMORY MANAGEMENT 

AND ESKAY ESKAX 
PDP-11 INSTRUCTIONS) (NATIVE INSTRUCTIONS) (QUICK VERIFY) 


ESKAX0O 
10236 
CONTROL 


ESKAX0O ESKAX00 
10236 10236 
CONTROL CONTROL 


ESKAX0O1 ESKAX0O1 
18000 18000 
CITS CITS 


ESKAXO1 
18000 
CITS 


TIMER AND CLOCK TESTS 


MEMORY 3822 
MANAGEMENT ESKAYO2, TEST 01 


COMPATIBILITY MODE 
ENTRY/EXIT 

6534 

ESKAXO2, TEST 1 


10000 ARITHMETIC, LOGIC, AND 
ESKAZO2 FIELD INSTRUCTION 
TEST 01 ESKAY 03, TEST 02 


BRANCH, CRC, AND 
QUEUE 
COMPATIBILITY ESKAYOS, TEST 04 


INSTRUCTIONS BRANCH, CRC, AND 

13500 QUEUE 

ESKAZ03 ESKAYO6, TEST O5 

TEST 02 OPERAND SPECIFIER 
FLOATING POINT DEPENDENT 
ESKAY 07, TEST 06 


FIRST PART DONE 
ESKAX04, TEST 2 


SBI 

VERIFICATION 
17155 

ESKAX0O5, TEST 03 


DECIMAL STRINGS 
ESKAY 08, TEST O7 


EDITPC OPERATORS 
ESKAYOY, TEST 08 


CHARACTER STRING 
INSSTRUCTIONS 
ESKAY10, TEST O9 


PRIVILEGED INSTRUCTION 
EXCEPTION, ESKAY11, TEST 10 


MEMORY VERIFY 
ESKAX0O6, TEST 04 


TK-0737 


Figure 6-1 CPU Cluster Exerciser Package Memory Allocation 
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HRAERRER CPU CLUSTER EXERCISER -- 9.9 ee 


PASS 1 TEST 6 SUBTEST 4 ERROR 1 .... . 

HARD ERROR WHILE TESTING CPU: EXCEPTION SERVICE ROUTINE 
UNEXPECTED EXCEPTION 

ERROR# 98000001 

VECTOR# 98000030 

SUBTYPE# 20000006 

PSL 83COG00B 


PC 98880110D 


Example 6-1 Unexpected Exception Error Message 


Refer to Chapter 2 of the VAX-11 KA78@ Central Processor Technical 
Description for a discusSion of vectors and subtypes. When the 
machine check vector is asserted, the exception handler attempts 
to log out relevant status registers on the stack before pushing 
two longword parameters (Summary and length) on the stack (Table 
6-1). In addition, the subtypes for vector 4 (machine check) are 
listed in Table 6-l. 


Table 6-1 Summary Parameter, Length Parameter for Vector 4 


Summary Parameter 


Subtype Byte @ 

Od CP Read Timeout/SBI Error Confirmation Fault 
G2 CP TBUF Parity Error Fault 

G3 CP Cache Parity Error Fault 

05 CP Read Data Substitute Fault 

OA Instruction Buffer TBUF Parity Error Fault 

GC Instruction Buffer Read Data Substitute Fault 
OA Instruction Buffer TBUF Parity Error Fault 

GC Instruction Buffer Read Data Substitute Fault 
OD IB Read Timeout/SBI Error Confirmation Fault 
OF IB Cache Parity Error Fault 
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Table 6-1 


Summary Parameter, Length Parameter for Vector 4 
(Cont) 


Summary Parameter 


Subtype 
FQ 
Fl 
F2 
F3 
F5 


F6 


Byte @ 

CP Read Timeout/SBI Error Confirmation Abort 
CS Parity Error Abort 

CP TBUF Parity Error Abort 

CP Cache Parity Error Abort 

CP Read Data Substitute Abort 

CP (Not Supposed To Be Here) Abort 

Byte 1 


This byte will be a nonzero value if a CP timeout 
or CP error confirmation interrupt is pending. 


Bytes 2 & 3 


These two bytes must be zero. 


Length Parameter 


Byte @ 


The number of bytes logged out are exclusive of 
this parameter. 


Byte l1--3 


These three bytes must be zero. 


When an unexpected interrupt or exception occurs, information is 
pushed on the stack by the exception handler as shown in Table 


6-2. 


Table 6-2 Information Pushed on the Stack 
by the Exception Handler 


SP: Length Parameter 


Summary Parameter 


CES CPU Error & Status GC 
Trapped UPC 
Virtual Address/ 


Virtual Instruction 
Buffer Address 


D Interface Between 08 (Bytes 1 & 3) 
Data Paths and 
Memory 
TBER@ Translation Buffer 12 
Error Register @ 
TBER1 Translation Buffer 13 
Error Register 1 
TIME.ADDR 1A 
PARITY Cache Parity Register 1lE 
SBI.ERR SBI Error Register 19 


PC 


Note that information on the stack is not saved by the exception 
handler. The EIH module must be breakpointed before this data is 
accessed. 
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6.2 COMMON INSTRUCTION TEST SERVICES MODULE (CITS) 

This module consists of a group of software routines that 
implement a table-driven test method for a majority of the VAX-11l 
instruction set. CITS interprets the contents of a specially coded 
test table and executes tests of VAX-11 instructions. CITS is also 
used for tests of the first part done function and memory 
management. A copy of each of these test instructions is coded in 
register deferred mode (RN). Before the test instruction is 
executed, the test data is placed somewhere in memory, and the 
registers are loaded with the addresses of that test data. After 
the test instruction is executed, the contents of the registers 
and the contents of the test data area of memory are checked. 


There are four main routines in CITS that do the work of executing 
tests: CITS DECODE, CITS SETUP, CITS EXECUTE, and CITS CHECK. 


66201 CITS DECODE 

This routine decodes one test table entry, in a table of cases, 
and generates directions for the other three routines to use. 
These directions are lists of addresses and other variables placed 
in the parameter blocks of the CITS data area. 


6.2.2 CITS SETUP 

CITS SETUP moves the test data from the common data pool into the 
operand buffer. The operand buffer is the location of the data 
referenced during execution of the test instruction. The locations 
to be used for destination data are filled with a _ standard 
background pattern, hexadecimal A5, in each byte. Also, each 
operand, whether source or destination, is preceded and followed 
by a longword of the background pattern. CITS SETUP loads 
registers R@--R6 with the operand addresses to be used by the test 
instruction. The initial PC and PSL calculated by CITS DECODE are 
pushed on the stack by CITS SETUP along with a return address. The 
return address points to a routine to save the result PSL and 
registers. 


6.2.3 CITS EXECUTE 

CITS EXECUTE enables the exerciser's exception handler to react 
properly for the current test. It passes the address of a CITS 
unexpected exception handler and enables validation of the 
exception of trace trap being tested, if any. CITS EXECUTE then 
executes an REI to Start the test. A NOP instruction precedes the 
REI and can be used for scope sync if the microbreak address is 
set up correctly from the console. When the test instruction 
finishes, the test subroutine returns to a result-saving routine. 
The PSL and registers R@--R6 are saved in the execution parameter 
block, as are the contents of the exception handler Interface Data 
Block (IDB). Also Saved iS an indication of whether the 
instruction branched, if it is a branch instruction. 


6.2.4 CITS CHECK 

CITS CHECK checks the results of instruction execution, and also 
checks the source operands and background pattern. It uses the 
directions and addresses put into itS parameter block by 
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CITS DECODE to control checking. It checks branches, the PSL, 
exceptions (whether an exception happened and at the right PC), 
registers R@--R6, and memory data. When checking memory data, 
CITS CHECK also checks the longword before and after each operand 
to make sure that the background pattern has not been disturbed. 

CITS CHECK keeps a list of all errors found during one test case. 
This complete list will be typed out when the test module using 
CITS makes the $DS ERRHARD call to the diagnostic supervisor. 


6.2.5 CITS SUBTEST 

CITS SUBTEST is a common subtest control routine that is used by 
most of the tests that call CITS. It processes a complete test 
table, calling the preceding four CITS routines in the proper 
order and calling the Supervisor error reporter when necesSSary. 


6.2.6 CITS Error Messages 


6.2.6.1 Message Heading -- A standard diagnostic Supervisor 
heading is typed (by the Supervisor). That is followed by an 
extended error printout that Supplies the test, subtest, and error 
numbers; the test case number; the op code of the failing 
instruction; addresses referenced; operand data; etc. Refer to 
Paragraph 6.4.2 for examples and detailed interpretation. 


6.2.6.2 CITS Subtest Troubleshooting Features -- SCOPE SYNC -- 
CITS EXECUTE executes a NOP instruction just before the REI to the 
test instruction. Putting the microaddress of 8E into ID Bus 
register 21 will cause a sync pulse to be generated on the 
microsequencer board (M8235) each time a NOP is executed. 

To loop on a failure with SCOPE SYNC, perform the following steps: 
>>> D /ID 21 8E 

>>> START 19000 

(DIAGNOSTIC SUPERVISOR STARTUP) 


DS> SET IE1,LOOPD 


DS> START /TEST: N (WHERE 'N' IS FAILING TEST NUMBER) 
ETC. 
. Halt Before the Failing Test Case -- At the beginning of 


the test-case executing loop, the case number 
(CITS CASE) is always incremented and compared with the 
content of CASE HALT. If these are equal, a HALT is 
executed. This feature allows the operator to stop before 
execution of a particular case, in order to examine 
registers, e.g., deposit the hex case number into 
CASE HALT. Run the test until the halt is executed. (If 
needed, use CONTINUE until you get to the right subtest.) 
Then either set a breakpoint or deposit a byte of zero (a 
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HALT) in CITS SYNC and type CONTINUE to get to that HALT. 
You have now stopped just before the REI to the test 
instruction of interest. Use the console to set up 
whatever operation you wish to perform and continue as 
desired. 


Figure 6-2 shows the sequence of events followed by CITS in the 
execution of ESKAY@3, test 2, the arithmetic, logic, and field 
instruction test module. 


6.2.6.3 Unexpected Exceptions in CITS -- If an unexpected 
exception occurs during a test, CITS will print a header 
containing the case number and the error information from the 
exerciser exception handler. This printout only occurs while CITS 
is handling unexpected exceptions, i.e., only during the execution 
of the five instructions before the test instruction and 
approximately through the three instructions after it (Example 
6-2). If an exception occurs outside of that set of instructions, 
then the error typeout is not handled by CITS and will not have a 
case number heading. 


kkkKKKRK CPU CLUSTER EXERCISER -- 9.0 ‘****keKE 
PASS 1 TEST 2 SUBTEST 1 ERROR 25 @ 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


? ERROR IN TEST CASE NUMBER: 25 


UNEXPECTED EXCEPTION 


ERROR# 90000001 


VECTOR# O80000004 


SUBTYPE# O9000000 
PSL OO1FODED 


PC 68000003 


Example 6-2 Unexpected Exception in CITS, Error Message 
Refer to Example 6-1 (Paragraph 6.1) for an explanation of the 
unexpected exception error message format. 
6.2.6.4 Result Register Errors -- If the contents of any of the 


registers R@--R6 are not as expected, CITS prints out initial, 
expected, and actual values, as shown in Example 6-3. 
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DIAGNOSTIC KAY 
SUPERVISOR ™” _ 


START 
CASE = 
CASE + 1 
COMMAND LINE 
INTERPRETER 
DEPOSIT 
OO IN CITS 
SYNC (HALT) 


CITS DECODE 
(DECODE CASE) 


DISPATCH | 
ROUTINE 


TEST 2 CITS - 
EXECUTE 

CITS - 
SUBTEST 


CITS - 
SYNC = 00 
HALT 


YES| STEP 


THROUGH 
INSTRUCTION 


REI, POP PC, 
POP PSL, EXECUTE 
INSTRUCTION 


RETURN FROM 
EXECUTION 


PRINT YES 
ERROR 
MESSAGE 


NO 


TK-0755 


Figure 6-2 Execution of a 
Test Case in ESKAY@3 
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kkkkkkkk KAeKKKKKK 


CPU CLUSTER EXERCISER -- 9.9 


PASS 1 TEST 2 SUBTEST 4 ERROR 17 @ 
HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 
2? ERROR IN TEST CASE NUMBER: 17 


? REGISTER CONTENTS ERROR 


INITIAL 

90005404 
980805414 
900905418 
GBBOOBHOD 
GOOOBOBO 
GOBGOOBOO 


GBDOBOHOOO 


EXPECTED 
G8903800 
GBBH8HHO 
GHOOOBOOD 
98085476 
GOOBOOOOD 
OE 


GOODGBOO 


ACTUAL 


90003880 


GBGB8BOO 


GOBBOHOOO 
980085476 
GGBBHOGO 
GBOHBOOO 


COBGBGOO 


Example 6-3 Result Register Errors 


Initial data shows the values loaded into the registers at the 
Start of the instruction. 


6.2.6.5 Leading or Trailing Background Errors -- If the longword 
before or the longword after an operand is changed during 
execution, CITS reports the error. Leading means the longword 
before the data (lower address than the data). Hexadecimal 
A5A5A5A5 is the standard background pattern. 


6.2.6.6 Data Errors -- When CITS detects a data error, part of 
the error typeout iS an operand number. That is, a number in the 
range 1 to 6 corresponding to the left-to-right order of the 
operands for the instruction. For example, in a MOVL instruction 
the source longword will be called operand 1 and the destination 
longword operand 2. 


If the incorrect operand is not of a writable or modifiable access 
type, then the error message includes the statement: read-only 
operand overwritten. 


If the incorrect operand iS writable or modifiable, then the error 
message includes the statement: incorrect result (Example 6-4). 


keeKKKEE CPU CLUSTER EXERCISER -- 9.0 **kkkkKE 


PASS 1 TEST 2 SUBTEST 7 ERROR 10 @ 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


? ERROR IN TEST CASE NUMBER: 19 
2 INCORRECT RESULT OPERAND 2 
EXPECTED ACTUAL 


CODBDOBO 49000000 


Example 6-4 CITS Detects a Longword Data Error 


Example 6-4 shows incorrect longword data. For word and byte data 
errors, the format is the same except that a word is typed as four 
hex digits, and a byte as two hex digits. In a quadword or 
double-floating word typeout, the lowest addressed longword is the 
first line of data typed. That is the longword containing the sign 
and the exponent for the double-floating case. (In the quadword 
case, the sign is in the longword typed on the second line of 
data, Example 6-5.) 


kkaKKKKE ==CPU CLUSTER EXERCISER -- 9.0 ***kkkKE 
PASS 1 TEST 2 SUBTEST 1 ERROR 91 @ 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 91 


2? INCORRECT RESULT, OPERAND 2 


EXPECTED ACTUAL 
GOSGOBOOO 996748D6 


GOGOODBO 8 6A2E9 9E 


Example 6-5 CITS Detects a Quadword Data Error 


Errors in string data (character string, packed decimal string, 
etc.) are displayed in Example 6-6. 
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kkkkkeEK = CPU CLUSTER EXERCISER -- 9.Q *##eeeHX 


PASS 1 TEST 2 SUBTEST 1 ERROR 44 9Q 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 44 

2? INCORRECT RESULT, OPERAND 4 
EXPECTED ACTUAL 

38 -- -A5A5 *39 *4E39... 


8 BYTES FROM START OF STRING 


Example 6-6 CITS Detects a String Data Error 


Each byte is typed as two hexadecimal digits. The expected data 
only shows the good value of the byte that did not compare. The 
actual data shows five bytes of the result string. The beginning 
of the string is to the left, the end is to the right. The left 
hand two bytes (four digits) are good result data; the byte 
between asterisks (*) is the one that failed to compare; and the 
right two bytes are the start of the rest of the (uncompared) 
String. The last line tells how far from the beginning of the 
String the bad byte is. 


6.2.6.7 PSL Errors -- Result PSL errors are typically wrong 
condition codes. The condition codes are the right-hand hex digit 
of the PSL. The E in the second from right-hand digit indicates 
that the decimal overflow, floating underflow, and integer 
overflow traps are enabled (Example 6-7). This condition is always 
true when the test instruction is being executed. 

ASAE A CPU CLUSTER EXERCISER -- 9.0 RARER EES 

PASS 1 TEST 2 SUBTEST 1 ERROR 58 @ 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 59 
2? RESULT PSL ERROR 


EXPECTED ACTUAL 


OO1IFOGES OO1FOBEI 


Example 6-7 PSL Error 
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6.2.6.8 Branch Errors -- When testing instructions that may 
branch, failure to branch when expected or a branch taken when not 
expected produces a message like that in Example 6-8. 


kkakAKKEE = CPU CLUSTER EXERCISER -- 9.0 ‘**#kkkkX 


PASS 1 TEST 2 SUBTEST 4 ERROR 1 @ 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


ERROR IN TEST CASE NUMBER: 1 


EXPECTED BRANCH DIDN'T HAPPEN 


Example 6-8 Branch Error 


6.2.6.9 Expected Exception or Trace Trap Errors 


Li An error mesSage is produced if an expected exception or 
trace trap fails to occur at all. 


2s The PC and PSL of expected exceptions and trace traps are 
checked. If an error is detected, a message like that in 
Example 6-9 is typed. 
kkkkkKK* = =CPU CLUSTER EXERCISER -- 9.0 ‘**#keek* 
PASS 1 TEST 2 SUBTEST 4 ERROR 2 @ 


HARD ERROR WHILE TESTING KA@: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 2 
2? INCORRECT EXCEPTION PC 


EXPECTED ACTUAL 


OBOBB25F5 98002566 


2? INCORRECT EXCEPTION PSL 
EXPECTED ACTUAL 


OB1FOBES5 OB1FOGE4 


Example 6-9 Expected Exception Error 


In Example 6-9 both the PC and the PSL were incorrect at the time 
of the exception. In Example 6-18 only the PSL was wrong at the 
time a valid trace trap occurred. 
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kkRKKKKK CPU CLUSTER EXERCISER -- 9.0 ******kX 


PASS 1 TEST 2 SUBTEST 2 ERROR 127 @ 


HARD ERROR WHILE TESTING KA@Q: INSTRUCTION TEST ERROR 


? ERROR IN TEST CASE NUMBER: 127 
2? INCORRECT TRACE TRAP PSL 
EXPECTED ACTUAL 


OB1FOOFD GO1FOOFS8 


Example 6-10 Trace Trap Error 


6.2.6.19 Extended Printout -- If the extended error printout 
flag is enabled, the following additional data will be typed out 
on error detection (Example 6-11). 

INITIAL CONDITIONS: 

PC 98004873 PSL OO1FOOFF 

OP CODE -- 74 WITH REGISTER INDIRECT OPERANDS 

INITIAL REGISTERS R@-R6: 

RQ GBBGACGH4 Rl @BBGAC14 R2 

R3 980 BAC 2D R4 GB8BGAC39 RS5 

R6 GBGBBBBO 

SOURCE OPERAND DATA: 

OPERAND 1 

FFFE 4FFF 

FFFFFFFF 

OPERAND 2 

FF 


OPERAND 3 


GBBB4980 


ODBGHBGO 


Example 6-11 Extended Printout 
6-14 


Notes for 


Example 6-l1l. 


dmg This is the first line of the extended typeout. PC is the 
location of the test instruction, which can be examined 
if the user wants to see the hex code. 

PSL is the value of the PSL before the instruction is 
executed. 

OP CODE is the hex value of the instruction, which in the 
example is 74 = EMODD. 

REGISTER INDIRECT OPERANDS means that R@ has the address 
of operand 1; Rl has the address of operand 2; etc. 

2 The INITIAL REGISTERS typeout tells where the operands of 
the test instruction were in memory when the instruction 
was executed. 

3. These are the actual contents of the addresses pointed to 
by the registers listed above (2). 

All source (read or modifiable) operands are typed. 
Formats: 
Byte XX 
Word XXXX 
Longword XXXXXXXX 
Quadword XXXXXXXX -- Low Address Longword 
XXXXXXXX -- High Address Longword 
Strings XX, XX, XX, XX,o0e 7 XX 
Left side of printout is lowest address byte. 
Long strings are printed 16 bytes per line and 
are continued for as many lines as needed. 
In the preceding example we have the following operands. (Refer to 
the VAX-11/78@ Architecture Handbook or the instruction card for 
further help.) 
Operand 1 MULR (RO) Double FFEFFFFFFF FFFE4FFF 
Operand 2 MULRX (Rl) Byte FF 
Operand 3 MULD (R2) Double GOGOOHGGH BBOB408O 
The 4th and Sth Operands are Destinations: 
Operand 4 INT (R3) Long 
Operand 5 FRACT (R4) Double 
6.2.7 How To NO-OP a Test Case 
If it is necessary to bypass a test case while waiting for a 
hardware ECO or a microcode ECO, refer to Example 6-12. 
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;CASE 195 
;SUBD2 INSTRUCTION 


me Be Be WE 


4) 
: 1.0 EXP-DIF: 1.0 
sCONDITION CODES INITIAL: 11ll EXPECTED: GBBO 


Oo 
4 
ry 


TB I_SUBD2, CC_NZVC, CC @, D8 D12, D8 D2, DP_D2 

@8F09D62 ~BYTE I SUBD2, <-C<I_SUBD2>>, <16*<CC_NZVC&15>+CC_@&15>> 
-BYTE DP D12 
~BYTE DP D2 
~BYTE DP D2 


Example 6-12 Case 1065 SUBD2 
Instruction 
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Load ESKAX.EXE 

Look up the base address of the PSECT <. BLANK .> in the link 
map of this program for the module that has the data for the 
test case to be No-Oped. 


set the console base register to that value (i.e., SE R: 
VALUE). 


Find the TB line of the right test case and examine it to make 
Sure you are in the right place (Example 6-12). 


Examination of 2C9 location (E 2C9) should give @8F#9D62. 


Count the number of single bytes following the line that has three 
bytes. That would be 3 for this example. 


Deposit a new longword, at the address just examined, made up of 
the count from the preceding step followed by @63FC. 


In Example 6-12, D 2C9 3@3FC, where 2C9 is the address just 
examined. 


Set the relocation register back to zero when finished (i.e., SE 
R: @). 


6.3 ESKAX DESCRIPTION 


6.3.1 Compatibility Mode Entry/Exit Module (ESKAX@2, Test 91) 
This module tests the conditions generated when the central 
processor enters and leaves the compatibility mode. The following 
conditions and functions are tested. 


ESKAX Test 1, Subtest 1 -- This subtest performs illegal entries 
in compatibility mode expecting and checking for reserved operand 
faults. The bit settings in the PSL that will cause reserved 
operand faults, on an attempt to enter compatibility mode, are 
Shown in Table 6-3. 


Table 6-3 Reserved Operand Faults and PSL Bit Settings 
on Compatibility Mode Entry 


PSL Bit/s Condition 
DV<7> Nonzero 
FU<6> Nonzero 
IV<5> Nonzero 
IPL<29: 16> Nonzero 
CUR MOD<25:24> Not = 3 
PRV MOD<23: 22> Not = 3 
IS<26> Nonzero 
FPD<27> Nonzero 


The conditions in Table 6-3 are tested one at a time. 
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The following two examples are typical of ESKAX test 1, subtest 1, 
error messages. 


Rae ES CPU CLUSTER EXERCISER -- 9.9 ad 


PASS 1 TEST 1 SUBTEST 1 ERROR 2 19-JUN-1977 21:25:41.22 


HARD ERROR WHILE TESTING CPU: EXCEPTION PC FROM CM ILLEGAL ENTRY 
INCORRECT 


VECTOR TYPE CODE EXPECTED PC ACTUAL PC PSL ENTRY MNEMONIC 


18 NONE G9807D74 99087D76 8 3CHGH8H DV 


Example 6-13 ESKAX Test 1, Subtest 1, Error 2 


REKKKEKKE CPU CLUSTER EXERCISER -- 9.9 REAR ERS 
PASS 1 TEST 1 SUBTEST 1 ERROR 2 19-JUN-1977 21:25:53.04 


HARD ERROR WHILE TESTING CPU: EXCEPTION PC FROM CM ILLEGAL ENTRY 
INCORRECT 


VECTOR TYPE CODE EXPECTED PC ACTUAL PC PSL ENTRY MNEMONIC 


18 @8007D74 G8007D54 83C 89848 FU 


Example 6-14 ESKAX Test 1, Subtest 1, Error 2 
Interpretation of Example 6-13. 


1. 18 is the reserved operand fault vector expected. 

2% There is no type code pushed on the stack. 

3 The state of the PSL to cause the fault was 83C0008@. 
4. DV is the PSL bit that was nonzero (Table 6-3). 

5. EXPECTED and ACTUAL PCs are self-explanatory. 


ESKAX Test 1, Subtest 2 -- Compatibility mode trap instructions 
upon a valid entry into compatibility mode (Table 6-4). 


Table 6-4 Compatibility Mode Trap Instructions 


Op code Mnemonic 
GB08H 3 BPI 
G8B0G4 IOT 
184909 EMT+@ 
194400 TRAP+@ 
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-- Compatibility mode reserved instructions upon a valid entry 
into compatibility mode (Table 6-5). 


Table 6-5 Compatibility Mode Reserved Instructions 


Op code Mnemonic 
G9GBOBDB HALT 
GO00G1 WAIT 
80005 RESET 
999230 SPL 
9864020 MARK 
8750080 FADD 
975919 FSUB 
975020 FMUL 
975830 FDIV 
179880 FP11 


Typical Error Messages 
kkeRKKKE CPU CLUSTER EXERCISER -- 9.0 *##kkeHE 


PASS 1 TEST 1 SUBTEST 2 ERROR 3 19-JUN-1977 21:29:30.48 


HARD ERROR WHILE TESTING CPU: EXCEPTION PSL FROM COMPATIBILITY 


MODE TRAP INCORRECT 
VECTOR TYPE CODE EXPECTED PSL ACTUAL PSL TRAP MNEMONIC 


30 1 8 3COBD8B 8 3COBGH2 0803 BPT 


Example 6-15 ESKAX Test 1, Subtest 2, Error 3 
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RARA ATE CPU CLUSTER EXERCISER -- 9.9 LEER 


PASS 1 TEST 1 SUBTEST 2 ERROR 3 19-JUN-1977 21:29:42.21 
HARD ERROR WHILE TESTING CPU: EXCEPTION PSL FROM COMPATIBILITY 
MODE TRAP INCORRECT 

VECTOR TYPE CODE EXPECTED PSL ACTUAL PSL TRAP 


30 2 8 3COBDBO 8 3CBOBB2 GBB4 


Example 6-16 ESKAX Test 1, Subtest 2, Error 3 


ARATE CPU CLUSTER EXERCISER -- 9.98 LEAS 

PASS 1 TEST 1 SUBTEST 2 ERROR 3 19-JUN-1977 21:29:54.62 
HARD ERROR WHILE TESTING CPU: EXCEPTION PSL FROM COMPATIBILITY 
MODE TRAP INCORRECT 


VECTOR TYPE CODE EXPECTED PSL ACTUAL SPL TRAP MNEMONIC 


30 3 8 3CBBBOD 8 3CBBBG2 8800 EMT 


Example 6-17 ESKAX Test 1, Subtest 2, Error 3 


Interpretation of Example 6-16 
Ls 38 is the compatibility mode TRAP vector expected. 
Zs A type code of 2 is pushed on the stack. 


3 Referencing Chapter 6 of the system reference manual 
would show that a typecode of 2 indicates an IOT fault. 


4. IOT is shown as well as the hex equivalent of the octal 
code (Table 6-4). 


Ds EXPECTED and ACTUAL PSLS are self-explanatory. 


Subtest 3 -- This subtest tests the T-bit trap by having the T-bit 
(PSL<4>) set upon entry into compatibility mode: 
a. for an instruction that does not trap 
b. for an instruction that does trap. 
NOTE 


Both a and b cases are _ serviced in 
NATIVE mode. 


6-20 


Typical Error Message 

RERRRE EE CPU CLUSTER EXERCISER -- 9.9 REEEKERE 

PASS 1 TEST 1 SUBTEST 3 ERROR 4 19-JUN-1977 21:32:06.8@ 
HARD ERROR WHILE TESTING CPU: A T-BIT TRAP NOT TAKEN 
EXPECTED EXC VECTOR TYPE CODE MNEMONIC 

GBCE 30 NONE TST RO 


Example 6-18 ESKAX Test 1, Subtest 3, Error 4 


Interpretation of Example 6-18 (this printout is for Case B): 

Le This instruction, which was to execute and then take a 
T-bit trap, was 'TST R@' with TRACE PENDING prior to its 
execution (PSL<TP>). 

2s The hex equivalent of the octal code for 'TST R@' is BC@. 

cP 38 is the vector expected to field the T-bit trap. 

4. No type code is pushed on the stack. 

Subtest 4 -- This subtest performs an RTT/RTI instruction with the 
T-bit set in the PSW image on the stack, which is to be popped 
from the stack by the RTT/RTI. 

Typical Error Messages 

kkkkREKK CPU CLUSTER EXERCISER -- 9.0 **#*#kkkK# 

PASS 1 TEST 1 SUBTEST 4 ERROR 3 19-JUN-1977 21:33:43.68 

HARD ERROR WHILE TESTING CPU: PC FROM RTT TRACE TRAP 


INCORRECT 


VECTOR TYPE CODE EXPECTED PC ACTUAL PC TRAP MNEMONIC 


30 NONE 08988588 98008408 9006 RTT 


Example 6-19 ESKAX Test 1, Subtest 4, Error 3 
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kkkkRKKK CPU CLUSTER EXERCISER -- 9.0 *** keke 


PASS 1 TEST 1 SUBTEST 4 ERROR 3 19-JUN-1977 21:33:54.70 


HARD ERROR WHILE TESTING CPU: PC FROM RTI TRACE TRAP 
INCORRECT 
VECTOR TYPE CODE EXPECTED PC ACTUAL PC TRAP MNEMONIC 


30 NONE 08808508 08008488 GBB2 RTI 


Example 6-28 ESKAX Test 1, Subtest 4, Error 3 
Interpretation of Example 6-19 
: 3@ is the vector expected to field the T-bit trap. 
; No type code is pushed on the stack. 
The RTT instruction was under test. 
The hex equivalent of the octal code for RTT is 6. 
: EXPECTED and ACTUAL PCs are self-explanatory. 
Subtest 5 -- This subtest performs checking of Odd Address errors 
while in compatibility mode. This is accomplished by executing a 
PDP-11 MOV instruction with unaligned SRC and DST operands. 
Typical Error Messages 
RAARARERAE CPU CLUSTER EXERCISER -- 9.9 RENEE 
PASS 1 TEST 1 SUBTEST 5 ERROR 4 19-JUN-1977 21:35:17.19 
HARD ERROR WHILE TESTING CPU: ODD ADDRESS TRAP CAUSED 
UNALIGNED SOURCE CONTENTS CHANGE 
VECTOR TYPE CODE EXPECTED VAL ACTUAL VAL TRAP MNEMONIC 


30 6 OOBA OOOE 1 7DF UNALIGNED 


Example 6-21 ESKAX Test 1, Subtest 5, Error 4 
RKKKEKKE CPU CLUSTER EXERCISER -- 9.0 RAR A TEES 
PASS 1 TEST 1 SUBTEST 5 ERROR 4 19-JUN-1977 21:35:29.58 
HARD ERROR WHILE TESTING CPU: ODD ADDRESS TRAP CAUSED 


UNALIGNED SOURCE CONTENTS CHANGE 


VECTOR TYPE CODE EXPECTED VAL ACTUAL VAL TRAP MNEMONIC 


30 6 OOBA OOOE 17DF UNALIGNED 
DST 


Example 6-22 ESKAX Test 1, Subtest 5, Error 4 
6-22 


Interpretation of Example 6-22 
De 38 is the compatibility mode TRAP vector expected. 
26 A type code of 6 is pushed on the stack. 


33 The position of the destination address on a _ boundary 
caused the failure. 


4. The hex equivalent of the octal code for the instruction 
under test is 17DF (this translates to 913737 in PDP-1l 
code). 


D4 EXPECTED and ACTUAL VALUES are self-explanatory. 


NOTE 
On an Odd Address trap neither SRC nor 
DST initial values should change, since 
the instruction should not go to 
completion. 


Subtest 6 -- This subtest performs checking of illegal 
instructions with a register destination, i.e., 

JMP R4 or 

JSR R4, R5 


Typical Error Messages 

ARERR ERE CPU CLUSTER EXERCISER -- 9.9 a a Tas 

PASS 1 TEST 1 SUBTEST 6 ERROR 3 19-JUN-1977 21:36:32.083 

HARD ERROR WHILE TESTING CPU: PSL FROM ILLEGAL INSTRUCTION 

TRAP INCORRECT 

VECTOR TYPE CODE EXPECTED PSL ACTUAL PSL TRAP MNEMONIC 
30 5 8 3COBB8O 8 3D00080 0044 JMP R4 


Example 6-23 ESKAX Test 1, Subtest 6, Error 3 


none ene eee CPU CLUSTER EXERCISER -- 9.9 RRAE EES 

PASS 1 TEST 1 SUBTEST 6 ERROR 3 19-JUN-1977 21:36:43.64 
HARD ERROR WHILE TESTING CPU: PSL FROM ILLEGAL INSTRUCTION 
TRAP INCORRECT 


VECTOR TYPE CODE EXPECTED PSL ACTUAL PSL TRAP MNEMONIC 


30 5 8 3CHBOBB 83800000 9985 JSR (R5 DST) 


Example 6-24 ESKAX Test 1, Subtest 6, Error 3 
6-23 


Interpretation of Example 6-24 
Ls 30 is the vector expected to field the TRAP. 
2% A type code of 5 is pushed on the stack. 
3% The instruction that failed was the JSR R4, RS. 


4. The hex equivalent for the octal code of this instruction 
is 9905. 


Ds EXPECTED and ACTUAL PSLS are self-explanatory. 
ESKAX®92 (test 1) is executed in the user mode for test purposes. 
However, the module is serviced in the kernel mode, and control is 


returned to the kernel mode on completion of the module. 


The operator should note that testing of the T-bit operation with 
servicing done in the compatibility mode has not been covered. 
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6.3.2 First Part Done Test (ESKAX@4, Test 2) 

First Part Done (FPD) is the name of bit 27 in the PSL. It 
provides a facility for interrupting certain potentially long 
executing instructions during processing and resuming them later. 
Only a few instructions are interruptable in this sense. Most 
instructions acknowledge interrupts before their execution, or 
acknowledge them in mid-operation by backing up to the beginning 
and pretending that they have not yet started. A few instructions, 
however, are potentially so lengthy that this is not feasible. 
These are the character and decimal string instructions, POLYF, 
POLYD, and CRC. Each of these instructions writes a control block 
into the general registers. Should an interrupt be requested 
during processing, the current state of the operation (i.e., what 
it is doing and how far it has gotten) can be saved in this 
control block to be retrieved after the interrupt is processed. 
The instruction then sets FPD in the PSL, and acknowledges the 
interrupt. Upon return from the interrupt, the FPD bit is set in 
the PSL, so that rather than restarting, the instruction restores 
its state from the point at which it was interrupted. 


6.3.2.1 Possible First Part Done Failures -- The microcode 
implementing the FPD capability must be able to correctly save and 
restore state anywhere it does a memory reference (which may cause 
a fault) and anywhere it checks for interrupts. The state of the 
operation in some cases is complex, and it is possible that the 
microcode doesS not save or restore everything correctly. If the 
instruction is later resumed, the state of the machine e.g., in 
the form of contents of general registers, may well have been 
changed by the instructions executed in the interim, and will thus 
be incorrect. This will cause unpredictable results, most likely 
in the form of incorrect data written, wrong lengths and wrong 
condition codes, and will be easy to detect. 


The instructions may also fail by Saving state (perhaps correctly) 
and failing to set FPD. This would normally appear when modified 
registers are used aS arguments in the restarting of the 
instruction. This condition will be detected in the test by 
checking in the interrupt routine to make certain that if FPD is 
still clear, the original arguments are unchanged. 


6.3.2.2 First Part Done Test Procedures -- The interval timer is 
used to generate interrupts during the testing of each 
instruction, in order to check the microcode and the taking of 
interrupts. Although each instruction is interrupted constantly 
during execution, it is eventually run to completion. 


After having been tested with interrupts, the instruction's 
ability to handle page faults is tested. An instruction may have 
up to six operands; twelve pages are set up to hold them, allowing 
each operand to be placed near an independent page boundary. When 
the instruction begins execution, each page is invalid. As it 
attempts to access itS operands, the instruction is repeatedly 
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faulted. Each fault validates the page referenced, so that the 
instruction progresses, but this alone does not ensure that it is 
tested fully. As each page is referenced (and faulted) the first 
time, all the other pages holding operands are made invalid. This 
process tests all the cases. Since each page has a first reference 
only once, the test instruction manages to finish. 


AS an example, consider the testing of an instruction with two 
string operands and one non-String operand in which the 
instruction accesses the non-String operand first, and then 
processes the strings (e.g., CMP3). First, the non-string operand 
is referenced, faulting the page containing it. Upon restart, the 
instruction fetches the non-string operand without problem, and 
begins processing the strings. Since each operand is located just 
before a page boundary, the strings will cross the boundaries. As 
the instruction progresses, it will attempt to reference the first 
page of the first operand, the first page of the second operand, 
the second page of the first operand, and the second page of the 
second operand. Because faulting in a page for the first time 
Signals the test to invalidate all the other pages, however, the 
string of references and validations proceeds as shown in Table 
6-6. 


Table 6-6 Page Faulting with First Part Done 


I I I I ;All the pages start invalid. 

FAULT I I I ;The first page is faulted 

V I I I ;and is made valid. 

V I F I ;The first page of operand 2 is 

I I V I ;faulted in, and the rest out. 

FAULT I V I ;Page 1 is refaulted, and page 

V I V I °3 is left valid. 

V F V I ;String 1 processing reaches 

I V I I ;page 2, all others faulted. 

I V F I ;Page 1 is not needed now, but 

I V V I ;page 3 still is needed. 

I V V F ;String 2 reaches its second 
;page 

I I V ;faulting page 4 for first 
stime. 

I V ;Page 2 is still needed, and 

I V ;is faulted back in. 

I V ;The instruction is completed. 


The first part done test uses the CITS routines to help set up, 
execute, and check the results of instruction tests. The 
instructions to test, and the data with which to test them, are 
Stored in a table. The table entries are of variable length, and 
they begin as shown in Table 6-7. 
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Table 6-7 First Part Done Test Table Entries 


~-BYTE g ;the op code of the test instruction 
~-BYTE Y) ;the op code's complement 

-BYTE 4 sinitial condition codes 

BYTE iy sresultant condition codes 

~-BYTE 4) ;operand specifiers 


The faulting section uses the Interface Data Block (IDB) to 
communicate with the exception and interrupt handler. The format 
of the IDB is shown in Table 6-8. 

Table 6-8 First Part Done IDB Format 


T-Bit Exception and State 
Count Subtype Bits 


PSL of exception 

PC of exception 

PSL of latest T-bit trap 

PC of latest T-bit trap 

User service routine address 

Number of arguments (zero) 
The service routine address points to the code that implements the 
faulting algorithm. The exception type and subtype are loaded with 


the values for translation-not-valid faults. 


This test also interfaces with the CITS routine through a Test 
Control Block (TCB). The TCB format is shown in Table 6-9. 


Table 6-9 First Part Done TCB General Format 
Current Test Table Address 
Unused Exception Subtype tT-bit trap 
Operand 1 address, or @ 
Operand 2 address, or @ 
Operand 3 address, or @ 
Operand 4 address, or @ 
Operand 5 address, or @g 


Operand 6 address, or @ 
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The current test table address points into the table of test 
instructions. 


The TCB passed to CITS DECODE and to CITS REDECODE is shown in 
Table 6-19. 


Table 6-18 First Part Done TCB Passed to CITS DECODE 


TCB: 

TCB_ INST ADDR: - LONG g scurrent test table address 

TCB T BIT: ~-BYTE 4) s;trace trap expected flag 

TCB SUBTYPE: »-BYTE 4 ;exception subtype 

TCB EXCEPTION: -BYTE @ ;expected exception vector 
~-BYTE 4 ; unused 

TCB OPERANDS: ~BLKL 6 optional operand addresses 


Typical Error Message 


kKkkkKkKKK 


CPU CLUSTER EXERCISER -- 9.Q *x#xkkKKE 


PASS 1 TEST 2 SUBTEST @ ERROR 212 19-JUN-1977 21:41:22.03 


HARD ERROR WHILE TESTING CPU: An unexpected type of fault 


occurred. 


Fault code Referenced address PC PSL 


GBGBOHBHO 


OOO1F7F8 98099 3DD¢ GBOGOSBEB 


Table number Test case 


1 


1 


TCB's address Test table address Current entry address 


GBOG8FIC 


GBBGBBATC GBBHBGATC 


Example 6-25 ESKAX Test 2, Subtest @, Error 212 


Interpretation of Example 6-25 
The printout is representative of the first part done test, which 
interfaces to the CITS portion of the program for its data pool as 


follows. 


ise 


2. 


This test interfaces with CITS through the TCB whose 
format is shown in Table 6-19. 


In this example, the first address of the TCB is 8F9C. 


The current test table address (which is the first 
longword of the TCB) is given as ATC. 


The starting address of the test table within CITS is 
A7C. 
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4. 


CITS contains a number of tables; each table contains a 
number of cases (or distinct pieces of data) where: 


Table 1 represents BASE FP instructions 
Table 2 represents DECIMAL instructions 
Table 3 represents EDIT PC instructions 
Table 4 represents FPA instructions 


A summary of the information presented so far on the 
First Part Done Test follows. 


ae 


b. 


The 


We are uSing Table 1 from CITS for our data. 
The starting address of this table is ATC. 
We are uSing DATA CASE 1. 

The address for DATA CASE 1 is ATC. 


The address of the CONTROL BLOCK guiding this test 
execution is 8F9C (whose format is Shown above in 
Table 6-10). 


Examination of the next n locations starting with the 
CURRENT ENTRY ADDRESS (in this case A7C) will give 
information concerning the instruction under test as 
follows: 


lst byte is the op code of the test instruction. 
2nd byte is the op code's complement. 

3rd byte is the INITIAL condition code (N,Z,V,C). 
4th byte is the RESULTANT condition code (N,Z,V,C). 


The next n bytes represent operand specifiers. 
The number of operand specifiers depends on the 
instruction under test. 


starting address of the area where the test 


instruction is placed (residing) while undergoing test is 
the PC of 3DDQ. 
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A Second Error Message 

kkkKKKKR CPU CLUSTER EXERCISER -- 9.0 *#kkkkee 

PASS 1 TEST 2 SUBTEST @ ERROR 213 19-JUN-1977 21:41:22.83 
HARD ERROR WHILE TESTING CPU: Page fault on non-test instruction. 
Fault Code Reference address PC PSL 

GBSOBHBOO OOO1FFFS GBGG3DD0 GOBOGOGEB 

Table number Test case 


1 1 


TCB's address Test table address Current entry address 


GBOGH8FIC GBBBGATC OBBBBATC 


Example 6-26 ESKAX Test 2, Subtest 9, Error 213 
Interpretation of Example 6-26 
The REFERENCE ADDRESS of I1FFF8 represents the address which caused 
the FAULT CODE of @. 
The breakdown of the FAULT CODE is as follows: 


Bit Position Meaning 


0 8 = translation not valid 
1 = access control violation 
1 1 = fault occurred during virtual reference to the 


PTE of the stored process virtual address 


read access 
write or modify access 


2 4 
1 


The interrupts portion of the test begins by setting up the test 
instruction and data, using the CITS routines named CITS DECODE 
and CITS SETUP. 


CITS SETUP returns with the PC and initial PSL of the test 
instruction on the stack. The test Saves a copy of the test 
instruction's PC and general registers, so that itS progress may 
be observed. Then the test initializes the interval timer service 
routine. 
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It then sets up a timer interrupt and executes an REI to the test 
instruction, which is interrupted immediately. 


Since the state of the instruction is contained in the registers, 
if they are unchanged since the previous interrupt, the 
instruction has not progressed. This condition results from 
interrupting too soon. In this case, the interval timer is 
increased, and the test instruction is resumed. 


In the other case, when the general registers have changed, the 
instruction has progressed. 


Next, a divide-packed instruction is executed in an attempt to 
modify the state of any internal registers that might be used by 
the instruction under test. The timer is then set up for the new 
wait time, started, and the test instruction is resumed. 


When the test instruction has been completed, the results are 
checked and any errors are reported. 


Once interrupts and faults have been tried, the next entry in the 
test instruction table is selected, and the testing of that 
instruction begins. 


There are four classes of errors that may occur. 


Class 1 -- Unexpected exceptions or interrupts. 
Class 2 -- Exception or interrupt identifier reports, which simply 
state 


ERROR IN TEST CASE NN. 

These occur when an exception or interrupt occurs during the 
testing of an instruction, and they are immediately followed by 
the exception report. They exist solely to inform the operator of 
the test case in which the exception occurred. 


Class 3 -- Instruction test errors describe incorrect results from 
instruction testing. The instructions tested are a subset of those 
tested in ESKAY@5 TEST#@4 and ESKAY@6 TEST@5, so that’ the 
instruction test errors are identical between those tests and this 
test, ESKAX@4 TEST@2. This data is in module ESKAX93 FPD DATA. 
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Class 4 -- These errors are first part done specific (Example 
6-27). 


They have error numbers 288 through 209. Each reports error 
specific information, the table number, and the test case number. 
The interpretation of table numbers is as follows: 


Table Number Meaning 

] Floating-point test table 
2 Decimal string test table 
3 EDITPC test table 

4 Floating-point test table 


(Executed with FPA enabled if an FPA 
exists) 


The test case number indexes into the appropriate table _ to 
indicate a single test. 


kkkKKKKKK CPU CLUSTER EXERCISER -- 9.0 **kkkKKR 
PASS 1 TEST 2 SUBTEST § ERROR 207 . 


HARD ERROR WHILE TESTING CPU: EXPECTED TIMER INTERRUPTS DIDN'T 
OCCUR. 


VALUE PASSES 
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TABLE NUMBER TEST CASE 


1 115 


TCB'S ADDRESS TEST TABLE ADDRESS CURRENT ENTRY ADDRESS 


18E@ 9F6 9F6 


Example 6-27 ESKAX Test 2, Subtest @, Error 207 


6.3.3 SBI Verification Module (ESKAX@5, Test 3) 

The SBI verification test is designed to exercise and partially 
diagnose faults on the SBI nexus connected to it. Error reports 
will differentiate between faults on the SBI proper and faults 
caused by a nexus. The error printouts will serve as guides to 
selection of the appropriate repair level diagnostic to further 
isolate the problem. 
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With the exception of the interactive mode setup subtest, errors 
will be reproducible via looping. For interactive mode, due to the 
asynchronous operation of the exerciser, only errors introduced by 
interrupts from the interval timer are guaranteed to be 
reproducible. 


Note that failing devices are deselected from further testing at 
the point of failure. This means that if an MBA or UBA fails ina 
test before MBE or UBE checkout, the MBES or UBES attached are not 
checked for the failing MBA or UBA. 


The SBI verification test is composed of the following parts. 


. SBI checkout -- Verifies configuration register of each 
nexus that can be accessed. 


. UBA checkout -- Verifies that each selected UBA on the 
SBI can sustain data transfers without incurring errors 
and that interrupts occur at the proper BR level. 


7 MBA checkout -- Verifies that each selected MBA on the 
SBI can sustain data transfers without incurring errors 
and that interrupts occur at the proper BR level. 


. SBI interaction -- Verifies that all UBAS are capable of 
block data transfers in a controlled sequential mode of 
operation. 


* UBE checkout -- Verifies that all existing UBES are 
capable of sustaining data transfers and interrupting on 
completion without errors. 


‘ MBE checkout -- Verifies that all existing MBEsS for 
selected MBAS are capable of sustaining data transfers 
and interrupting on completion without errors. 


6.3.3.1 SBI Checkout Subtest -- The SBI checkout subtest will 
perform reads and writes to the configuration register of each 
nexuS on the SBI as defined by the hardware P-Table. This subtest 
will set up the Hardware Interrupt Request Table (HIRT), which 
will contain an entry for each UBA and/or MBA responding to a read 
of its configuration/status register. This table will be used by 
all subtests within the SBI verification test. A nexus that does 
not respond will not be entered into the HIRT and, therefore, will 
not be used in the following subtests. No response from a nexus is 
treated aS an error. 


6-33 


The SBI checkout subtest uses the CPU silo comparator register to 
check the validity of the commands and responses from the 
receiving nexus on the SBI. 


The primary purpose of this subtest is to provide the field user 
with a detailed check of the SBI. It will isolate faults in such a 
manner that the error information printed will aid the user in the 
selection of the proper diagnostic, which may then be run to 
further isolate the fault. 

. Silo Compare Servicing -- The silo compare service 
routine will read back the SBI silo and compare the 
contents with the arguments supplied in the _ IDB 
(interface data block). Null cycles between command 
issue and read reply are checked for continuity of 
function, i.e., TR lines not continually asserted. No 
checking will be made for the number of null cycles. 


On completion of the silo read back, the fault bit in the CPU SBI 
status register will be checked for clear. The error flag will be 
set and the appropriate information will be placed on the error 
Stack if it is set. The fault bit will be reset if set. The 
interrupt on silo compare bit will be cleared and the SBI silo 
compare register will be cleared. 


A return is then made to the point of invocation of the interrupt 
cauSing this routine to be executed. 
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6.3.3.2 UBA Checkout Subtest -- This subtest will only be run for 
UBAs that exist in the HIRT and have been qualified by the SBI 
checkout subtest. 


Each UBA will be set up to operate in a wraparound mode so that 
access from the SBI to UnibusS memory space will be mapped into SBI 
memory space. 
This subtest will check the following UBA capabilities. 

l. DDP and BDPl1 data paths are operational. 


2% Interrupts can be initiated by the adapter and result in 
the correct vector being accessed. 


3% The map registers can be accessed and used correctly. 
4. Purging operates correctly. 
5% A read to nonexistent UnibuS memory Space causes the 


correct error sequence and interrupt. 


The subtest will autosize the UnibusS memory and set the map 
register disable portion of the Unibus Adapter Control Register 
(UACR) for usSe by other subtests within the SBI verification test. 


Faults detected within this subtest will cause the UBA under test 
to be disqualified from further use by any other subtest within 
the SBI verification test. 


UBA Interrupt Servicing -- InterruptS generated by the Unibus 
Adapter are serviced by this routine. 


The routine will compare the configuration register and the Unibus 
Adapter Status Register (UASR) with arguments supplied in the 
Service Data Block (SDB). If there are any differences, they will 
be pushed on the error stack and the error flag will be set. For 
an invalid map register type interrupt, the failed mapped entry 
register will be compared with the SDB entry. Also, for a Unibus 
SSYN timeout, the failed Unibus address register will be compared 
with the SDB entry. 


The AEIL (Additional Exception or Interrupt Longword) is used as 
the transfer vehicle to indicate to the interrupted program the 
IPL level at which the interrupt occurred. 

6.3.3.3 MBA Checkout Subtest - This subtest is run only on MBAs 


that exist in the HIRT and have been qualified by the SBI checkout 
subtest. 


Each MBA is set up to operate in maintenance mode. 
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This subtest checks the following MBA capabilities. 


Le Initialization clears registers and does not cause 
interrupts. 


2s DT BUSY can be set and causes no interrupts. 
3% PGE can be set and causes an interrupt. 
4. Read and write transfers operate correctly; on completion 


of read data transfer, DONE is set and causes an 
interrupt. 


Faults detected within this subtest cause the MBA under test to be 
disqualified from further use by any other subtest within the SBI 
verification test. 


MBA Interrupt Servicing -- Interrupts generated by the Massbus 
adapter are serviced by this routine. 


This routine compares the status register with an argument 
supplied in the SDB. 


If there are any differences, the SDB + 2 will be set to indicate 
error and the error information will be put into the appropriate 
Slots in the Master Control Space (MCS). 


6.3.3.4 SBI Interaction Subtest -- After the UBAS are set up for 
wraparound operation, the following data transfer types are 
initiated. 


l. read word 
2 write byte 
34 write word 
4. modify byte 
oer modify word 
6.3.3.5 UBE Checkout Subtest -- This subtest determines’ the 


number and location of Unibus exercisers for each Unibus adapter 
and checks each as it is found. If no faults are detected, the UBE 
is entered in the HIRT and the qualify bit will be set. 


Only qualified UBAS are used during this subtest. If none exists, 
the subtest will be skipped. 


UBAS are set up with two map registers pointing to SBI memory 
Space. One map uSes the Direct Data Path (DP@) and the other uses 
buffered Data Path One (DPl). All interrupts are enabled. 


Autosizing is used to determine the location of a Unibus 
exerciser. 
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Each exerciser is checked for the following two capabilities: 
des ability to execute DATO, DATI functions, 


2% ability to interrupt at BR levels 4 through 7 following a 
function. 


If any of the above conditions is not met, the UBE is not entered 
in the HIRT. 


UBE Interrupt Servicing -- The contents of the BRRVR and UBA base 
address are passed into the test from the master exception and 
interrupt handler. In addition, the routine performs the following 
four functions. 


i If bit 31 is set in the BRRVR value read, then call the 
UBA service routine. 


2s Derive the UBE address from the vector supplied in the 
low word of the BRRVR value. 


3% Examine bit 15 (error bit) of CRl. If the bit is set, 
push the error type information and contents of the 
control registers, CRl and CR2, on the error stack and 
set the error flag. Clear the error bit. 

4. Return. 


6.3.3.6 MBE Checkout Subtest -- This subtest determines if an MBE 
is present for each MBA that has been previously qualified. 


Each exerciser will be checked for the following: 


eg read transfers 
Pe write transfers. 


Additionally, the MBA is checked for whether 


i Attention can be set which causes an interrupt. 
2s Massbus exception can be set which causSes an interrupt. 


If any of the above conditions is not met, the MBE is not entered 
in the HIRT. 
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Typical Error Messages for the SBI Verification Module: 


ARAL ALS CPU CLUSTER EXERCISER -- 9.8 EEREAERS 


PASS 1 TEST 3 SUBTEST 2 ERROR 10 19-JUN-1977 21:53:25.6h 
HARD ERROR WHILE TESTING UBA: INVALIDATED MAP REGISTER ACCESS 
ERROR: DESTINATION OVERWRITTEN 


ADD ACCESS NEXUS ADD MR ADD FUNC EXP DATA ACT DATA 


201009F8 6B9BB600O 600868120 WRITE 25255252 24255252 


Example 6-28 ESKAX Test 3, Subtest 2, Error 19 


RKKEKKES CPU CLUSTER EXERCISER -- 9.98 SAREE RNE 
PASS 1 TEST 3 SUBTEST 3 ERROR 4 19-JUN-1977 21:57:83.12 


HARD ERROR WHILE TESTING MBA@: MBA WRITE 


ERROR: RESULT 
ADD ACCESS NEXUS ADD EXP DATA ACT DATA 


60819490 609010000 GBSDH2000 GBBH2400 


Example 6-29 ESKAX Test 3, Subtest 3, Error 4 


REE CPU CLUSTER EXERCISER -- 9.98 ARRAS A 
PASS 1 TEST 3 SUBTEST 3 ERROR 4 19-JUN-1977 21:57:13.907 


HARD ERROR WHILE TESTING MBA1: MBA WRITE 


ERROR: RESULT 


ADD ACCESS NEXUS ADD EXP DATA ACT DATA 


68012400 60912000 GBBOH2000 GB0B300B 


Example 6-38 ESKAX Test 3, Subtest 3, Error 4 
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Interpretation of Example 6-28 
These printouts are typical of ESKAX Test 2, where: 


l. The nexus address iS 609086000. A nexus is defined as a 
physical connection to the SBI. In this case the nexus is 
the UBA. 


2 Since the SBI deals in 3@-bit addresses, 18-bit Unibus 
addresses must be translated to 3@-bit SBI addresses. 
This function is performed by the Unibus adapter through 
one of the 496 UBA memory map registers, as shown in 
Table 6-1ll. 


Table 6-11 Unibus Adapter Map Register Address Offsets 


Offset from the 


Unibus Memory Page UBA Base Address 
Y 880 

1 894 

2 888 

3 8 BC 

4 8190 

495 FBC 

: FCO 

: ° Reserved 

: FFC 


In the example given, the MR ADDRESS is 68096810. The underlined 
portion of the address (using Table 6-11) tells us that we are 
working with the map register for Unibus memory, page 4. 

One Unibus memory page equals 512 bytes. 


3. The function performed was a write. 


4. Each UBA has an associated Unibus address space with a 
physical starting address as follows: 


UBA Number Physical Starting Address 
) 280190000 
i 201400080 
2 20180000 
3 201C 8000 


From Example 6-28 the ADDRESS ACCESSED is 2@1009F8, indicating 
UBA @ under test. 


oe EXPECTED and ACTUAL DATA are self-explanatory. 


6.3.3.7 Memory Verify (ESKAX#6 TEST#4) -- Not yet implemented. 
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6.4 ESKAY 


6.4.1 Interval Timer and Day Clock Verification Module 
(ESKAY@2 TEST®@1) 

This module tests the interval timer and the day clock. The 
interval timer is used extensively throughout the cluster 
exerciser package during interactive operation. 


6.4.1.1 Interval Timer Functions 


Subtest 1 -- The interrupt enable bit in the control status 
register can be set and cleared. 


Typical Error Message 


sal ial CPU CLUSTER EXERCISER -- 9.0 aa alias 


PASS 1 TEST 1 SUBTEST 1 ERROR 2 18-JUN-1977 66:38:05.10 


HARD ERROR WHILE TESTING CPU: INTERRUPT ENABLE BIT CAN'T BE 
CLEARED 


Example 6-31 ESKAY Test 1, Subtest 1, Error 2 


Subtest 2 -- This subtest checks that the transfer bit (bit @4) in 
the control status register can be set, thus activiating a 
transfer of the contents of the next interval register to the 
Current interval register. 

A check that the transfer bit is read as @ is also performed. 


Typical Error Messages 


kekkkKREK CPU CLUSTER EXERCISER -- 9.0 ‘*#kkkkKR 
PASS 1 TEST 1 SUBTEST 2 ERROR 1 18-JUN-1977 6:39:58.61 


HARD ERROR WHILE TESTING CPU: XFER BIT STUCK AT 1 


Example 6-32 ESKAY Test 1, Subtest 2, Error l 


kkeKKKKE CPU CLUSTER EXERCISER -- 9.0 ‘**kkKRKE 


PASS 1 TEST 1 SUBTEST 2 ERROR 2 18-JUN-1977 66:39:58.61 


HARD ERROR WHILE TESTING CPU: XFER FROM NEXT INTERVAL TO INTERVAL 
COUNT INCORRECT 


Example 6-33 ESKAY Test 1, Subtest 2, Error 2 


6-40 


Subtest 3 -- The single clock bit (bit 5) in the control status 
register can be set, thus causing the current interval register to 
advance by one. 


The test also checks that the single clock bit is read as zero. 


kkRKKKKK CPU CLUSTER EXERCISER -- 9.9 %***ekKKE 


PASS 1 TEST 1 SUBTEST 3 ERROR 2 18-JUN-1977 66:43:14.82 


HARD ERROR WHILE TESTING CPU: SINGLE CLOCK BIT NOT FUNCTIONING 
PROPERLY 


Example 6-34 ESKAY Test 1, Subtest 3, Error 2 


Subtest 4 -- This test floats a one through a field of zeros in 
the current interval register. The medium of transfer is the 
read/write unit comprised of the current interval register and the 
next interval register, respectively. Since the next interval 
register is write-only, only the current interval register is 
checked at the end of the transfer. If a failure is detected in 
the current interval register, it is possible that the failure 
originated in the next interval register. 


Typical Error Message 

kkRKKEKE = CPU CLUSTER EXERCISER -- 9.0 ***kkeHH 

PASS 1 TEST 1 SUBTEST 4 ERROR 1 18-JUN-1977 96:44:31.89 

HARD ERROR WHILE TESTING CPU: ADJACENT PIN STICKING IN INTERVAL 
COUNT REGISTER 


EXPECTED RESULT RECEIVED RESULT ENTRY VALUE 


OBBHBBG4 GBOGBHBO OBBBB004 


Example 6-35 ESKAY Test 1, Subtest 4, Error 1 


Interpretation 


Ls The ENTRY VALUE of 600090004 represents the value loaded 
into the next interval register (hex 19). 


2's The EXPECTED RESULT of 68000004 represents what’ the 
content of the current interval register (hex 1A) should 
be after the transfer is complete. 


cr The RECEIVED RESULT is self-explanatory. 
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Subtest 5 -- This subtest checks the carry bits of the current 
interval register. This is accomplished by preloading the next 
interval register with the value to force the carry, transferring 
this to the next interval register, and then single-clocking to 
force the carry expected. 


Typical Error Message 


kkaeAKKE =~=CPU CLUSTER EXERCISER -- 9.0 ‘***kkkKE 


PASS 1 TEST 1 SUBTEST 5 ERROR 1 18-JUN-1977 66:45:59.65 


HARD ERROR WHILE TESTING CPU: INTERVAL TIMER COUNTING NOT 
PROCEEDING PROPERLY 


EXPECTED RESULT RECEIVED RESULT ENTRY VALUE 


GBGBOGHH2 GBGOHOB1 GBGGOBH1 


Example 6-36 ESKAY Test 1, Subtest 5, Error 1 


kkkkKKK CPU CLUSTER EXERCISER -- 9.9 ****e**# 
PASS 1 TEST 1 SUBTEST 5 ERROR 1 18-JUN-1977 66:45:508.65 


HARD ERROR WHILE TESTING CPU: INTERVAL TIMER COUNTING NOT 
PROCEEDING PROPERLY 


EXPECTED RESULT RECEIVED RESULT ENTRY VALUE 


GBDBOHBH4 GBBBOKHB3 GBGBHBH3 


Example 6-37 ESKAY Test 1, Subtest 5, Error 1 


Interpretation of Example 6-36 


Ls The ENTRY VALUE of 988000081 represents the value loaded 
into the next interval register (hex 19). 


Zo The EXPECTED RESULT of 99880002 represents what’ the 
content of the current interval register (hex 1A) should 
be after the transfer is complete and the single clock 
bit has been ticked once. 


3. The RECEIVED RESULT is self-explanatory. 
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Subtest 6 -- This subtest checks that the error bit in the control 
Status register will set in the case of a current interval 
register overflow occurrence before a previous interrupt has been 


serviced. 


The error messages are self-explanatory. 


EEE AAS CPU CLUSTER EXERCISER -- 9.98 al el 


PASS 1 TEST 1 SUBTEST 6 ERROR 1 18-JUN-1977 @6:53:13.11 


HARD ERROR WHILE TESTING CPU: INTERRUPT REQUEST NOT SET ON 
OVERF LOW 


Example 6-38 ESKAY Test 1, Subtest 6, Error 1 


alk al Ric CPU CLUSTER EXERCISER -- 9.9 LAER AAAS 
PASS 1 TEST 1 SUBTEST 6 ERROR 2 18-JUN-1977 66:53:13.11 


HARD ERROR WHILE TESTING CPU: ERR NOT SET FROM UNSERVICED OVERFLOW 


Example 6-39 ESKAY Test 1, Subtest 6, Error 2 


Subtest 7 -- This subtest checks the run bit of the control status 
register with the interrupt enable bit not set (i.e., a check of 
no interrupt capability). 

Typical Error Message 

kkkkKKK = ==CPU CLUSTER EXERCISER -- 9.0 *#ekkkHE 


PASS 1 TEST 1 SUBTEST 7 ERROR 3 18-JUN-1977 96:53:13.11 


HARD ERROR WHILE TESTING CPU: ERR BIT SET -- SHOULD NOT BE 


Example 6-4@ ESKAY Test 1, Subtest 7, Error 3 


Subtest 8 -- This subtest checks the run bit of the control status 
register with the interrupt enable bit set, a check of interrupt 
Capability. A check is also made to verify that the interrupt is 
enabled at IPL 24 (hex 18). 
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Typical Error Message 


kkkRRKKR CPU CLUSTER EXERCISER -- 9.0 ****ee## 


PASS 1 TEST 1 SUBTEST 8 ERROR 2 18-JUN-1977 @6:55:56.48 


HARD ERROR WHILE TESTING CPU: INTERRUPT OCCURRED AT OTHER THAN IPL 
24 


IPL WAS 18 


Example 6-41 ESKAY Test 1, Subtest 8, Error 2 


Interpretation of Example 6-41 


l. The IPL WAS would indicate at what IPL level the 
interrupt did occur (if other than IPL 24). 


6.4.1.2 Day Clock Function 
Subtest 9 -- This subtest checks the ability of the time of day 
register to advance from a known state, given 2@ ms to do So. 


Typical Error Message 


kkkkKKEK CPU CLUSTER EXERCISER -- 9.0 **#kkKKE 
PASS 1 TEST 1 SUBTEST 9 ERROR 1 18-JUN-1977 66:58:26.79 


HARD ERROR WHILE TESTING CPU: TIME OF DAY CLOCK NOT INCREMENTING 


Example 6-42 ESKAY Test 1, Subtest 9, Error 1 


Subtest 18 -- This subtest checks the ability of the time of day 
register to accept a back-to-back loading of two different and 
unique values. 


Typical Error Message 


kkkakEEK =~ CPU CLUSTER EXERCISER -- 9.0 **kkkkKK 
PASS 1 TEST 1 SUBTEST 18 ERROR 2 18-JUN-1977 @6:59:43.78 


HARD ERROR WHILE TESTING CPU: DOUBLE LOADING OF TIME OF DAY NOT 
CORRECT 


EXPECTED RESULT RECEIVED RESULT 1ST LOAD 2ND LOAD 


AAAAAAAC AAAAAAAA 595555555 AAAAAAAA 


Example 6-43 ESKAY Test 1, Subtest 19, Error 2 
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Subtest 11 -- This subtest checks for any stuck-at-zero bits in 
the time of day register. 


Typical Error Message 


kkkRKKER ~~ CPU CLUSTER EXERCISER -- 9.0 **#**kkRE 


PASS 1 TEST 1 SUBTEST 11 ERROR 1 18-JUN-1977 @07:800:30.34 


HARD ERROR WHILE TESTING CPU: ADJACENT PIN STICKING IN TIME OF DAY 
REGISTER 


EXPECTED RESULT RECEIVED RESULT ENTRY VALUE 


FFFFFFFE FFFFFFFF FFFFFFFD 


Example 6-44 ESKAY Test 1, Subtest 1l, Error 1 
Subtest 12 -- This subtest checks the Carry bits of the time of 
day register. This is accomplished by preloading the time of day 
register with the value to force the Carry, and then expecting a 
Carry bit in approximately 14--15 ms. 
kkkkKKKK CPU CLUSTER EXERCISER -- 9.0 ****kkeX 
PASS 1 TEST 1 SUBTEST 12 ERROR 2 18-JUN-1977 67:95:02.22 


HARD ERROR WHILE TESTING CPU: TIME OF DAY COUNTING NOT PROCEEDING 
PROPERLY 


EXPECTED RESULT RECEIVED RESULT ENTRY VALUE 


GOBGBOHG2 GOOOGOO1 GBSGHGOO1 


Example 6-45 ESKAY Test 1, Subtest 12, Error 2 


Interpretation of Example 6-45 


Li The ENTRY VALUE of 9890800001 is what is initially loaded 
into the time of day register. 


2. The EXPECTED RESULT of @@808002 is the final value 
expected to be in the time of day register approximately 
14 ms after the initial load. 

3. The RECEIVED RESULT is self-explanatory. 


In addition, the test checks for stuck-at-zero bits in the time of 
day register. 
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6.4.2 Arithmetic, Logic, and Field Instruction Test Module 
(ESKAY@3, Test @2) 

This module tests the integer arithmetic, logical, and field 
instruction microcode and associated hardware. CITS performs all 
of the functional control, building expected data patterns, 
executing the instructions to be tested, and checking the results. 


The following two printouts are typical of error reports coming 
from this test. 


a. One shows a reSult PSL error. 
b. The second shows incorrect operand result contents. 


AERA ES CPU CLUSTER EXERCISER -- 9.98 a a Sialtl 


PASS 1 TEST 2 SUBTEST 1 ERROR 1 6-AUG-1978 11:34:41.92 
HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 
? ERROR IN TEST CASE NUMBER: 1 
2? RESULT PSL ERROR 
EXPECTED ACTUAL 
GBOOBBES GOOOOGEI 
INITIAL CONDITIONS: 
PC 980004958 PSL SBBOBBKEF 


OP CODE -- 98 WITH REGISTER INDIRECT OPERANDS 


INITIAL REGISTERS R@--R6: 

RQ GOGOAEG4 Rl G90 G8AEOD R2 GBDBBOOO 
R3 GBOOGHBO R4 GOOBDHBO R5 GOSOOBGOO 
R6 GBOOHOHO 

SOURCE OPERAND DATA: 

OPERAND 1 


85 


Example 6-46 ESKAY Test 2, Subtest 2, Error 1 
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*#kkkKKKK =~CPU CLUSTER EXERCISER -- 9.9 ‘*#kkkkKE 
PASS 1 TEST 2 SUBTEST 1 ERROR 31 6-AUG-1978 11:35:27.25 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 31 
2? INCORRECT RESULT, OPERAND 2 
EXPECTED ACTUAL 
90004300 98804304 


OBSOODBHBO GOGHBOHOO 


INITIAL CONDITIONS: 

PC O@OGO0B46FA PSL BOOBOGEF 

OP CODE -- 6C WITH REGISTER INDIRECT OPERANDS 
INITIAL CONDITIONS: 

RQ GOOBAEGD4 Rl GBOGAEBD R2 Ts 
R3 GOOHBOOO R4 GOOOBOBO R5 GOGHBOBO 


R6 POBBHBOO 


SOURCE OPERAND DATA: 
OPERAND 1] 
21 


Example 6-47 ESKAY Test 2, Subtest 1, Error 3l 
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Interpretation of Example 6-47 


i The op code 6C defines the instruction under test as 
CVTBD (you can know this by simply looking up the given 
op code on a coding card). 


De The general format of this instruction (again from 
looking at the code card) is as follows: 


op code scr.rx, dst.wy 


The statement WITH REGISTER INDIRECT OPERANDS indicates 
that the form of the instruction being tested is CVTBD 
(RO), (R1). 


NOTE 
All instruction testing is set up so 
that the first operand always uses R@, 
second operand always uses Rl, third 
operand always uses R2, etc. 


3% The initial conditions PC and PSL should be 
self-explanatory. 


4. The TEST CASE NUMBER of 31 shows nothing more than how 
far into the current test table we are, i.e., 39 
instruction types were tested up to this point with no 
errors. 


For all intents and purposes, you can ignore this number. 


5s The error indication of INCORRECT RESULT, OPERAND 2 
states that the final contents of the destination operand 
were wrong. OPERAND 2 is shown above as (Rl). 


6. The SOURCE OPERAND DATA of 21 is self-explanatory. 


7. The INITIAL REGISTERS R@--R6 Specify the addresses in 
memory in use for the instruction. In this case, CVTBC 
(AE@4), (AE@D). 


NOTE 
R2 through R6 contain @8s since the CVTBD 
instruction uses only two operands. 


8. Finally, the EXPECTED value of 4308 and the ACTUAL value 
of 4304. 


If you examine the content of AE@D (/W) it should contain 
4304. 


Example 6-48 is another form of printout similar to the preceding 


two examples with a twist. An unexpected exception occurred during 
the testing of an instruction. 
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kkkKKKKK CPU CLUSTER EXERCISER -- 9.0 **kkkkK 
PASS 1 TEST 2 SUBTEST 3 ERROR 1 6-AUG-1978 11:34:42.57 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 1 
UNEXPECTED EXCEPTION 

ERROR# 98000001 

VECTOR# 88090034 

SUBTYPE# 90800001 

PSL @80000EB 


PC 900904933 


INITIAL CONDITIONS: 
PC 980084930 PSL BBBOBDED 


OP CODE -- 8E WITH REGISTER INDIRECT OPERANDS 


INITIAL REGISTERS R@9--R6: 

RG GOBBAED4 Rl G9B8GAEOD R2 GBOBOBHO 
R3 GBDBGOOOD R4 GOGOOGOOO R5 GOOBGOOO 
R6 GBOBOHOOD 

SOURCE OPERAND DATA: 

OPERAND 1 

80 


Example 6-48 ESKAY Test 2, Subtest 3, Error l 
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Interpretation of Example 6-48 


Lis The unexpected exception occurred through VECTOR 34 
(Paragraph 2.7 of the KA78@ Central Processor Technical 
Description lists VECTOR 34 as the ARITHMETIC TRAP 
vector). 


2% The SUBTYPE of 1 informs you that the condition was 
INTEGER OVERFLOW (Paragraph 2.7 of the KA78@ Central 


Processor Technical Description). 


3 The PC of 4933 and PSL of EB are those existing at the 
time of the exception occurrence. 


4. The ERROR 1 is nothing more than a repetition of the 
ERROR 1 printout of the header report. 


55 The rest of the printout is as outlined for the two 
printouts preceding (i.e., the same breakdown applies). 


6.4.3 Branch, CRC, and Queue Test Module (ESKAY@4, Test 93) 
Not yet implemented. 


6.4.4 Floating-Point Instructions Test Module (ESKAY95, Test 4; 
ESKAY#@6, Test 5) 

Tests 4 and 5 check both the basic floating-point instructions and 
the accelerated floating-point instructions. Arithmetic and 
reserved operand exceptions pertaining to floating-point 
instructions are also tested. Since the FPA takes part in the 
execution of MULL2 and MULL3, the tests also check these 
instructions. The floating-point accelerator is turned off for 
test 4 and on for test 5. 
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Typical Error Messages for Test 4 
kxeekKKKKK = =CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.0 ‘**kkkkKS 
PASS 1 TEST 4 SUBTEST 1 ERROR 2 20-FEB-1978 11:26:00.00 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 2 
? RESULT PSL ERROR 
EXPECTED ACTUAL 


OB1FOGE3 OO1FOGEI 


INITIAL CONDITIONS: 
PC 96004428 PSL OBO1FOGEF 


OP CODE -- 4F WITH REGISTER INDIRECT OPERANDS 


INITIAL REGISTERS R@--R6: 
RG G08BACH4 Rl GBBBAC1OB R2 GBBBGACIC 
R3 GODBHBOD R4 PODSHIOO R5 DODGBOBOOD 


R6 GBBSBHOO 


SOURCE OPERAND DATA: 


OPERAND 1 
GBBB488O 
OPERAND 2 
OBOB408O 
OPERAND 3 
DDOOSBOD 


Example 6-49 ESKAY Test 4, Subtest 1, Error 2 
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a as CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.9 LEASE TS 
PASS 1 TEST 4 SUBTEST 1 ERROR 7 26-FEB-1978 11:26:00.00 
HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 
2? ERROR IN TEST CASE NUMBER: 7 
? RESULT PSL ERROR 
EXPECTED ACTUAL 
GG1FOGES GOB1FOGE4 
INITIAL CONDITIONS: 
PC 98004695 PSL O@O1FOBEB 


OP CODE -- 71 WITH REGISTER INDIRECT OPERANDS 


INITIAL REGISTERS R@--R6: 
RQ GOBGACH4 Rl G@BHGAC14 R2 GBDBSHBO 
R3 GCBSCBGBOO R4 POABOBHO R5 GBSOBHBOOD 


R6 GODSBOBO 


SOURCE OPERAND DATA: 


OPERAND 1 
DBBH4B8O 
GBHBOBOD 
OPERAND 2 
GBBG4080 
GBGBOBOHO 


Example 6-5@ ESKAY Test 4, Subtest 1, Error 7 
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KRKKKEKK CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.9 


PASS 1 TEST 4 SUBTEST 1 ERROR 24 20-FEB-1978 11: 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 24 
? RESULT PSL ERROR 
EXPECTED ACTUAL 


GB1FOGESB GB1FOOED 


INITIAL CONDITIONS: 

PC 00004873 PSL OG1FOOEF 

OP CODE -- WITH REGISTER INDIRECT OPERANDS 
INITIAL REGISTERS R@#--R6 

RO SBOBACH4 Rl GBBGAC14 R2 SBBGAC1D 
R3 G08 BAC 2D R4 G88 BAC39 R5 GBOCHOOO 
R6 GOGOHHOO 


SOURCE OPERAND DATA: 
OPERAND 1 

FFFE 4FFF 

FFFFFFFF 

OPERAND 2 

FF 

OPERAND 3 

GBBH408O 


DOBOBHDO 


kKkk&kkkkk 


26: 00.00 


Example 6-51 ESKAY Test 4, Subtest 1, Error 24 
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A lengthy detailed description of this type of error report has 
been supplied in Paragraph 6.4.2. Using that description as a 
reference, interpretations of the preceding three error reports 
follow. 

Interpretation of Example 6-49 

The instruction being tested is 


ACBF (R@), (Rl), (R2), displacement 


BREAKING DOWN FURTHER-- 
ACBF (AC@4), (AC1@), (AC1C), displacement 


BREAKING DOWN FURTHER-- 
ACBF i 4980, 8, displacement 
’ 


limit addend index 
Interpretation of Example 6-59 
The instruction being tested is 
CMPD (R@), (R1) 


BREAKING DOWN FURTHER-- 
CMPD (AC@4, (AC14) 


BREAKING DOWN FURTHER-- 
CMPD 4080, 4880 


source destination 
Interpretation of Example 6-51 
Going through a similar analysis 


EMODD (R@), (Rl), (R2), integer, fraction 


EMODD FFFE 4FFF GBSG408G 
FFFFFFFF, FF, GQ0O08GHBG, integer, fraction 
floating- multiplicand 


point multiplier 


floating-point 
multiplier extension 
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Typical Error Messages for Test 5 
kkkKKKKK CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.0 ***kkkKR 
PASS 1 TEST 5 SUBTEST 2 ERROR 7 20-FEB-1978 11:26:09.00 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


? ERROR IN TEST CASE NUMBER: 7 
2? INCORRECT TRACE TRAP PSL 
EXPECTED ACTUAL 


OB1FOOFS OO1FOOF4 


INITIAL CONDITIONS: 

PC 908004695 PSL OG1FOGFB 

OP CODE -- 71 WITH REGISTER INDIRECT OPERANDS 
INITIAL REGISTERS R@--R6: 

RQ GOBBACB4 Rl G80GAC14 R2 GBSBHOBD 
R3 GBOBBOBO R4 GOOBGHOO R5 DBBSBOGOD 


R6 GBBSBOOO 


SOURCE OPERAND DATA: 
OPERAND 1 

GBBG4G80 

GSBAGHOO 

OPERAND 2 

GBBH4AV8B 

GBOBHSHOO 


Example 4-52 ESKAY Test 5, Subtest 2, Error 7 
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REESE CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.9 ERR EAA 


PASS 1 TEST 5 SUBTEST 8 ERROR 190 298-FEB-1978 11:26:900.00 


HARD ERROR WHILE TESTING CPU: FLOATING NORMALIZE SUBTEST 


2? ERROR IN TEST CASE NUMBER: 113 
EXPECTED ACTUAL 


FFF849FF GOOO3F8O 


TEST AT PC: @0@009A87 ADDF3 RO, R2, R4 


RG 98084880 


R2 @88088C040 


Example 6-53 ESKAY Test 5, Subtest 8, Error 106 


RERRERES CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.98 EAAAR AAS 
PASS 1 TEST 5 SUBTEST 8 ERROR 181 20-FEB-1978 11:26:90.00 


HARD ERROR WHILE TESTING CPU: FLOATING NORMALIZE SUBTEST 


¢ ERROR IN TEST CASE NUMBER: 161 
EXPECTED ACTUAL 
GBGBH4D40 GBBB4B00 


GOSOSWOD GOGOGOHO 


TEST AT PC: 986809B1ll ADD3 ROB, R2, R4 


Rl O88 BCHOD 
R2 FFFF4D7F 


R3 OGBBESOO 


Example 6-54 ESKAY Test 5, Subtest 8, Error 191 
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The interpretation of Example 6-52 is similar to that already 
given for Example 6-47. 


Examples 6-53 and 6-54 are for the FLOATING NORMALIZE SUBTEST and 
differ from the standard CITS printouts as follows: 


De Both printouts give the instructions under test and their 
operands, 1.e., 


ADDF3 RG, R2, R4 
ADD3 RQ@, R2, R4 


2. The operand data is listed directly under the TEST AT PC 
statements. 


ce The EXPECTED and ACTUAL data in both cases reference the 
contents of R4 (R4, by definition, specifies the 
destination operand). 


6.4.5 Operand Specifier Dependent Floating-Point Test (ESKAY8@7, 
Test 6) 
Not yet implemented. 


6.4.6 Decimal Strings Module (ESKAX@8, Test 7) 

This module tests the microcode and hardware used for decimal 
string execution. 

Interpretation of Example 6-55 

The error printouts coming from this test are designed like those 
of test 5. An overall interpretation has already been described in 
the test 2 writeup. 

Analysis should show the instruction under test to be 

ADDP6 (RO), (Rl), (R2), (R3), (R4), (R5) 


addladdr | add2addr | Sumaddr 
addllen add2len sumlen 


with ADDRESSES REFERENCED shown under INITIAL REGISTERS R@--R6 and 
OPERAND DATA as indicated. 


6.4.7 EDITPC Operators Module (ESKAY8@9, Test 8) 
This module tests the EDITPC microcode and associated hardware. 
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Typical Error Message 
AARRERERE CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.9 BRR RAR 
PASS 1 TEST 7 SUBTEST 2 ERROR 26 20-FEB-1978 11:26:809.090 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


2? ERROR IN TEST CASE NUMBER: 26 
2? INCORRECT TRACE TRAP PSL 
EXPECTED ACTUAL 


OB1FOOFS8 OO1FOOFD 


INITIAL CONDITIONS: 
PC 90004585 PSL OO1FOOFF 


OP CODE -- 21 WITH REGISTER INDIRECT OPERANDS 


INITIAL REGISTERS R@--R6 
RQ OBBBACH4 Rl GOBGACHE R2 0888AC1B 
R3 GBOGOBAC25 R4 GBBHBBAC35 R5 SOOBAC3F 


R6 GBSBHBOO 


SOURCE OPERAND DATA: 

OPERAND 1 

GBB9 

OPERAND 2 

12, 34, 56, 78, 9C 

OPERAND 3 

OOOE 

OPERAND 4 

02, OB, OB, 77, 77, 77, 77, TE 
OPERAND 5 


OO1F 


Example 6-55 ESKAY Test 7, Subtest 2, Error 26 
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Typical Error Message 
kkekKKKK CPU CLUSTER EXERCISER (ZZ-ESKAY) -- 9.0 ‘**kkkkKX 
PASS 1 TEST 8 SUBTEST 1 ERROR 48 20-FEB-1978 11:26:00.00 


HARD ERROR WHILE TESTING CPU: INSTRUCTION TEST ERROR 


? ERROR IN TEST CASE NUMBER: 48 
2? RESULT PSL ERROR 
EXPECTED ACTUAL 


OB1FOGES OD1FOGE4 


INITIAL CONDITIONS: 
PC @600485A PSL @O1FO0EB 


OP CODE -- 38 WITH REGISTER INDIRECT OPERANDS 


INITIAL REGISTERS R@--R6: 

RO GBGGACH4 Rl GGOSGACHE R2 OBHOSGACIE 
R3 GBBGAC2F R4 GOOCOBHOD R5 POSOBGOBO 
R6 GBBGBOOO 

SOURCE OPERAND DATA: 

OPERAND l 

OBOOF 

OPERAND 2 

00, 86, OB, BH, BB, BH, BB, BD 

OPERAND 3 

40, 40, 43, 25, 04, OF, 46, 18, OB 


Example 6-56 ESKAY Test 8, Subtest 1, Error 48 
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Interpretation of Example 6-56 
The error printouts coming from this test are designed like those 
described in Paragraph 6.4.2. 


Therefore, analysis should show the instruction under test to be 
EDITPC (RO) , (Rl), (R2), (R3) 
srclen pattern 
srcaddr dstaddr 


with ADDRESSES REFERENCED shown under INITIAL REGISTERS R#--R6 and 
OPERAND DATA as indicated. 


6.4.8 Character String Instructions Test Module (ESKAY1@, Test 
9) 
Not yet implemented. 


6.4.9 Privileged Instruction Exception Test (ESKAYl11]1, Test 10) 
Not yet implemented. 


6.5 ESKAZ DESCRIPTION 


6.5.1 Memory Management Test Module (ESKAZ63, Test 1) 

The object of this test is to test memory management on a 
VAX-11/788 CPU. Memory management is that part of the CPU which 
checks protection on memory references, performs virtual to 
physical address translation, monitors updates to pages of memory 
(with the modify bit of the page table entry), and resolves 
unaligned data references. These functions are tested by making 
many different kinds of references to see that they work. Working 
is defined as: reading or writing the correct data, leaving the 
contents of adjacent addresses unaffected, setting the M bit on 
the first write to a page, and faulting if required. Upon 
detecting a failure, the test issues an error report containing 
the failure symptom (e.g., unexpected fault, wrong’ condition 
codes) and the circumstances surrounding the failure (instruction 
and address under test, expected and received data, etc.). 


The test is organized in six subsections, each testing some area 
of memory management functionality. 


Les Valid read and write -- The intent is to quickly verify 
that the basic functions work. Longword aligned reads and 
writes are performed to each address space (P@, Pl, and 
System). This process performs initial checks of reading 
and writing, physical address translation in each address 
Space, translation buffer loading, and setting of the 
modify bit. 
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Length register boundary checks - References are made 
Just before and just beyond each of the length boundaries 
to verify the length boundary checks. 


Page Table Entry (PTE) combinations -- This subsection 
changes privilege modes to kernel, exec, super, and uSer. 
It makes references to pages mapped with each access 
code, and with the PTEs both valid and invalid, to verify 
the access privilege checks. 


Size with PTE combinations -- The size of the access is 
varied from byte to quadword and tried with PTE 
combinations. 


Page boundary checks -- The size of the access and the 
position of the access with respect to a page boundary 
are varied. 


IB references with PTE combinations -- This SubSection 


attempts to make instruction buffer references’ while 
varying the protection of the referenced page. 
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6.5.1.1 Memory Management Test General Flow 

Initialization -- Three buffer areas are requested from the 
Supervisor, one each from P@, Pl, and system spaces. A control 
block (BVAS) is loaded with their addresses, and with the 
addresses of three other buffer areas, which are on the last page 
in each space. 


Execution of Subsections -- A loop selects and executes each of 
the subsections, as follows. 


ds Select an SCC -- The entry in the subsection description 
table associated with the current subsection is selected. 
It includes a pointer to a Setup Command Chain (SCC). 
There is an SCC for each subsection. The execution 
section includes six nested loops, varying access size, 
address space, and operand alignment. The SCC contains 
start and end limits for these loops. For instance, the 
ScC for the fourth loop, page boundary checks, specifies 
varying access size from byte to quadword, varying the 
offset from a page boundary from 8 bytes before through l 
byte after the page boundary, and varying address space 
from P@ to system. 


2% Create defaults -- DefaultS are provided for any 
variables not specified in the SCC. 


3% Execute subSection -- A procedure is called that will 
make test references, varying each reference variable 
specified in the SCC across the range. 


Clean up -- At the end of the test, all buffers are returned and 
control returns to the dispatch routine in the Supervisor. 


6.5.1.2 Memory Management Test, Subsection Flow 
Loop start -- All reference parameters that will vary are loaded 
with initial values specified in the SCC. 


Execute -- The test reference described by the current state of 
all the reference variables is made. 


Increment -- The next value of the most rapidly varying parameter 
is loaded. If its range has been covered, it is set to its initial 
value and the next variable is changed. 


Loop -- If the slowest varying reference parameter has completed 
its range, the subsection iS complete. Otherwise, the next 
reference 1S made. 


6.5.1.3 Test Reference Execution 
Initialize -- The control blocks for this section (MRDB and TCB) 
are set up. 


Decode -- A CITS (CITS DECODE) is called to decode the test 
instruction. 
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Simulate -- The test reference is simulated, and the expected 
results are loaded into the MRDB. 


Setup -- Another CITS routine (CITS SETUP) is called to initialize 
the data areas, general register, and stack for the test 
instruction. 


Map -- The address of the test reference is mapped according to 
the variables controlling page validity and accessibility. 


Probe -- A probe is made to the test address in order to verify 
the mapping, and the results are compared with the simulated 
results. 


Execute -- The test reference is made. 


Remap -- The test address mapping is reset to allow all access, 
and the result maps are copied and checked. 


Data Check -- CITS CHECK is called to check the results of the 
test instruction. 


Loop -- The flow from setup is repeated for various translation 
buffer states. 


Return. 


6-63 


Typical Error Messages 
kkkKKKEE CPU CLUSTER EXERCISER -- 9.0 ‘*****kee 
PASS 1 TEST 1 SUBTEST 1 ERROR 20212 28-MAY-1978 98:31:01.89 


HARD ERROR WHILE TESTING CPU: LENGTH REGISTER BOUNDARY 


ERROR OCCURRED DURING: ACCESS OR ACCESS CHECK 


ERROR: PAGE TABLE ENTRY WAS MODIFIED 


TESTED PSL MODE ACCESS ACCESS 
ADDRESS PRV CUR TYPE SIZE 
8OGH1FF8 K K R L 
PTE PTE PROTEC- V-BIT M-BIT ACCESS ALLOWED 
TION 
ADDRESS VALUE CODE STATE STATE K_ E Ss U 
SPTE1: @@01F43C 98090098 90893 VAL CLR R NO NO NO 


SYS BASE SYS LENGTH 
REG REG 


OOO1F 400 GBBOOB22 


EXP DATA ACT DATA PTE MODIFIED 
09800898 GB8GHBG98 SPTE1: 


Example 6-57 ESKAZ Test 1, Subtest 1, Error 298212 
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TRALEE CPU CLUSTER EXERCISER -- 9.9 Ae ee 

PASS 1 TEST 1 SUBTEST 1 ERROR 20213 28-MAY-1978 @8:58:58.91 
HARD ERROR WHILE TESTING CPU: LENGTH REGISTER BOUNDARY 

ERROR OCCURRED DURING: ACCESS OR ACCESS CHECK 


ERROR: MODIFY BIT ERROR 


TESTED PSL MODE ACCESS ACCESS TESTED OPERAND 
ADDRESS PRV CUR TYPE SIZE INSTR NO. 
6813001F8 K K W L MOV G2 

PTE PTE PROTEC- V-BIT M-BIT ACCESS ALLOWED 

TION 

ADDRESS VALUE CODE STATE STATE K_ E Ss U 
SPTE1: @001F480 988000094 9802 VAL SET RW NO NO NO 
T-BUFF 
STATE 
MISS 
PPTE1: @801F200 988900094 GBB2 VAL SET RW NO NO NO 

HIT 


SYS BASE SYS LENGTH 
REG REG 

GOO1F 40 GBOWBH22 
Pl BASE Pl] LENGTH 
REG REG 

7FCO LADD OD1GOOOF 
EXPECTED PTE 

STATE 

SET SPTE1: 


Example 6-58 ESKAZ Test 1, Subtest 1, Error 28213 
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Interpretation of Example 6-5/7 


Te 


SO , 


CHECK 


First, a discussion of ERROR 298212 


All error numbers consist of 3 bytes with a breakdown as 
follows: 


Ae 


The left byte (2) defines the location within the 
test where the error was encountered 


where, 
@ = Subtest 


1--6 = Subsection defined prior to the preceding 
examples (Paragraph 6.5.1). 


The middle byte (@2) indicates the action being taken 
by the test at the time of error 


where, 

@ = SETUP 

1 = PROBE/PROBE CHECK 

2 = ACCESS/ACCESS CHECK 
3 = ACCESS DATA CHECK 

4 = FINAL SETUP 


The right byte (12) is indicative of the error itself 
(it is used by the test software to determine what 
gets printed at error report time). 


the ERROR number tells us that we were in the LENGTH 
REGISTER BOUNDARY subSection (2) performing an ACCESS/ACCESS 


(@2), when we got a message saying PAGE TABLE ENTRY WAS 


MODIFIED (12). 


26 


3. 


The ADDRESS UNDER TEST was 8@001FF8. 


The PREVIOUS and CURRENT MODES in the PSL at the test 
time are shown aS K K 


where, 

K = Kernel 

E = Executive 
S = Supervisor 
U = User 
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The ACCESS occurring at the time of the error is shown as 
R 


where, 

R = Read 

W = Write 
M = Modify 


The SIZE of the access is shown as L 


where, 

L = Longword 

B = Byte 

W = Word 

Q = Quadword 

A discussion of the line labeled SPTE1 follows. 


In the given example we have only one line of 
information, but depending on the set of circumstances 
there can be more than one line (as shown in Example 
6-58). 


The lines and combinations that can appear are as 
follows: 


SPTE1: Page 1 system page table 
SPTE2: Page 2 system page table 
PPTE1: Page 1 processor page table 
PPTE2: Page 2 processor page table 


where, 


Page 1 = page number of the address of the lowest byte of 
the reference address as determined by either the Base 
Virtual Address (BVA) or, if the position is negative, by 
the BVA + position. 


Page 2 = the next page. 
NOTE 
A reference may be either entirely 
within PAGE 1 or PAGE 2, or it may cross 
over. 


In our example, the PAGE 1 system page table is being 
ACCESSED. 
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The PHYSICAL ADDRESS of the PTE is l1F43C. 
NOTE 
The PTE is the medium of translation of 
all virtual addresses to. physical 
addresses. 
The PTE VALUE represents the contents of the PTE or 98. 
The PTE content comprises 4 fields. 


a. Page Frame Number (PFN) -- Bits <20:90@> 


This is the upper 21 bits of the physical address of 
the base of the page. 


b. Modify bit -- Bit <26> 
c. Protection -- Bits <3@:27> 
ad. Valid -- Bit <3l1> 


The PROTECTION CODE for the page accessed was 3. 


Chapter 5 of the VAX-11 System Reference Manual gives an 
analysis of a protection code meaning. 


To ease the strain of searching through the VAX-11 System 
Reference Manual, the protection code breakdown is shown 
under ACCESS ALLOWED as R, NO, NO, NO. 


This states that the page being accessed can be READ in 
kernel mode, and cannot be accessed in any other mode. 


NOTE 
A W under this column would indicate 


that the page can be written in a given 
mode. 
The state of the valid bit (V-BIT) is VAL 


where, 


VAX 


1 (valid) 


12. 


INV = @ (invalid) 


The state of the modify bit (M-BIT) is CLR 
where, 
CLR = @ (no modify) 


SET 


1 (modify) 
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i. 


14. 


The content of the SYSTEM BASE REGISTER was 1F4@@ and the 
content of the SYSTEM LENGTH REGISTER was 22. 


These 13 items represent the SETUP portion of the error 
report (i.e., what were all the initial conditions, or 
States, at the time of the error). 


The SYS BASE REG and SYS LGTH REG printouts always occur 
aS parts of the SETUP. As a function of the TESTED 
ADDRESS value, one or two other printouts will occur 
additionally as follows: 


a. If bit 31 is clear and bit 38 is set, the message 
includes 


Pl BASE Pl LENGTH 
REG REG 


b. If bit 31 is clear and bit 3@ is clear, the message 
includes 


P@ BASE P@ LENGTH 

REG REG 
The ERROR portion of the printout shows further proof of 
the ERROR: PAGE TABLE ENTRY WAS MODIFIED statement by 


showing the EXPECTED and ACTUAL DATA and the PTE 
MODIFIED. 


Example 6-58 iS Similar to Example 6-57 except that it shows 
additional information which reflects circumstances at the time of 
the error. 


The new items in Example 6-58 are: 


TESTED INSTR is a MOV 

The OPERAND NO. in question is @2 (i.e., the DST). 
The translation buffer state (TB-STATE) is listed 
where, 


HIT = 1 
MISS = @. 
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6.6 COMPATIBILITY MODE INSTRUCTION TEST (ESKAZ93, TEST 2) 


6.6.1 Instructions Tested 

Most of the instructions provided by the compatibility mode 
hardware are exercised uSing various data patterns and address 
modes (Figure 6-3). These instructions are listed in Table 6-12. 


START 


SUBTEST 


SETUP RN: 


SUBTEST 
INSTRUCTION 


VERIFY 


Y 
ERROR LOOP 
EN: 


Orr 


GO TO 
NEXT 


SUBTEST 


TK-1200 


Figure 6-3 Compatibility Mode Instruction Module Subtest 
Structure 
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Table 6-12 


Op Code (8) 


-855DD 
-@6SSDD 
- @63DD 
-862DD 

- 4SSDD 

- 5SSDD 

- 3SSDD 
499-3777 
1888900-3777 
-@59DD 

- 2SSDD 
-@51DD 
240-277 
-@53DD 
-@52DD 


Compatibility Mode 
Compatibility Mode Hardware and Exercised by ESKAZ Test 2 


BRANCHES (*) 


BRANCHES (**) 
CLR (B) 

CMP (B) 

COM(B) 

CND CODES (***) 
DEC(B) 

INC (B) 


Instructions 


9081DD 
98 4RDD 
- LSSDD 
-@54DD 
-961DD 
-86ADD 
- 8820R 
GBOGH6 


- 8@56DD 
97 7RNN 
16SSDD 
%883DD 
%9867DD 
-857DD 
874RSS 


where, 


(*)=BR, BNE, 


BEQ, BGE, BLT, BGT, BLE 
(**)=BPL, BMI, BVC, BCC, BCS, BHI, BLOS, 


(***)=CLC, CLV, CLZ, CLN, CCC, SEC, 


BHIS, 
SEZ, 


Provided 


JMP 
JSR 
MOV (B) 
NEG (B) 
ROL (B) 
ROR (B) 
RTS 
RTT 
SBC (B) 
SOB 
SUB 
SWAB 
SXT 
TST (B) 
XOR 


BLO 
SEN, 


by 


The instructions provided by the compatibility mode hardware that 
have not yet been included in this test are listed in Table 6-13. 


Table 6-13 


Compatibility Mode Instructions Not Yet Tested 


Op Code (8) 


972RSS 
973RSS 
@71RS5S 
1865SS 
@865SS 
1®66DD 
8866DD 
8798RSS 
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Mnemonic 


NOTES 
1. The test instruction is always 
tagged IN. 


2. The error is always tagged EN. 


3. The return point for looping is 
always tagged RN. 


4. If more than one verification is 
made in aesingle subtest, the 
entries to subsequent checks are 
tagged AN, BN, etc. 


5. If more than one error is included, 
subsequent errors are tagged El1N, 
E2N, E3N, etc. 


The RTI instruction provided by compatibility mode hardware is not 
tested in this module. The compatibility mode entry/exit module 


(ESKAX#2, 


6.6.2 


Test @1) tests this instruction thoroughly. 


Compatibility Mode Test Error Message Format 


The following header is printed when an error is detected. 


(PC) (PSW) (SP) (R1) (R2) (R3) (R4) 


Interpretation of Compatibility Mode Test Error Message Format 


(PC ) 


(PSW) 


(SP) 


Indicates the content of the program counter at the time 
of the error call. This is normally an address that is 
used to locate the error call statement in the failing 
subtest. 


Indicates the content of the processor status word at the 
time of the error call. 


Indicates the content of the stack pointer (R6) at the 
time of the error. 


NOTE 


The error call will push the _ stack 
twice. 
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(R1) Indicates a mnemonic of the instruction under test 
e.g., MOVB, ASL... etal. 


(R2) For single- and double-operand instructions, R2 normally 
contains the destination address. 


(R3) For sSingle- and double-operand instructions, R3 contains 
what the result (destination operand) actually was after 
the test instruction was executed. 


(R4) For Ssingle- and double-operand instructions, R4 contains 
what the result (destination operand) should have been 
(S/B). 


In some cases, the error information may deviate from that 
previously described but the program annotation for those subtests 
will describe the meaning of those entries that have been 
redefined. 


The error call statement is encoded to print only the information 
relative to the particular function being tested. Interpretation 
of the error calls is shown below. 


ERROR Print all 7 columns 

ERROR] Print only column 1 

ERROR2 Print columns l, 2 

ERROR3 Print columns 1, 2, 3 

ERROR4 Print columns 1, 2, 3, 4 
ERRORS Print columns 1, 2, 3, 4, 5 
ERROR6 Print columns 1, 2, 3, 4, 5, 6 


kkkkKKKKK CPU CLUSTER. . : kkkkKKKK 
PASS 1 TEST XX SUBTEST 208 ....... 
HARD ERROR WHILE TESTING CPU: COMPATIBILITY MODE .... - 


(PC) (PSW) (SP) (Rl) (R2) (R3) (R4) 


0898 8DD0 GBGBHGO4 OOBHASAA MOV GBOGB400 OOBHOOOD OOOOFFFF 


Example 6-59 ESKAZ Compatibility Mode Test Error 
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Interpretation of Example 6-59 


8DDO Represents the PC of the error call in the listing. 

4 Represents the content of the PSW prior to the error 
call. 

A5AA Represents the last position of the PDP-1ll1 mode stack 
pointer (R6). 

MOV Is a clue that the MOV inStruction failed under test. 

49 Represents the address used by the destination mode 


portion of the MOV instruction. 


GBSO Represents the actual content of the destination after 
instruction execution. 


FFFF Represents what the content of the destination should 
have been after the MOV instruction was executed. 


The listing is laid out with a subtitle printed at the top of each 
page. The operator can look through the program listing for 
subtest 298. The subtest description of 208 Shows that a MOV 
instruction is tested with source mode 2 and destination mode 3. 


6.6.4 Compatibility Mode Instruction Module Assumptions 
Four compatibility mode trap instructions are used to control the 
execution of this test, as follows. 


Ls SUBTYPE @ (SPL) Used as program end indicator. 
2% SUBTYPE 2 (IOT) Used as next subtest indicator. 


NOTE 
Appears as SCOPE statement in listing. 


36 SUBTYPE 3 (EMT) Used as error report indicator. 


NOTE 
Appears aS ERROR + XX statement in 
listing. 


4. SUBTYPE 4 (TRAP) Used as PSW reference indicator. 


NOTE 
Appears as TRAP + XX statement in 
listing. 


It is assumed that the test performing the exercising of 
compatibility mode entry/exit conditions has been executed prior 
to this test, in which event, the compatibility mode trap 
instructions have been checked out. 
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APPENDIX A 
GLOSSARY OF DIAGNOSTICS SOFTWARE TERMS 


absolute (ABS) -- A program section (psect) attribute. An absolute 
psect contains only symbol definitions. It does not contribute 
binary code to the image. Therefore, it must have a zero-length 
memory allocation. The converse is relocatable (REL). 


access mode -- Any of the four proceSsor access modes in which 
software executes. Processor acceSs modes are, in order, from most 
to least privileged and protected: kernel (mode 9), executive 
(mode 1), Supervisor (mode 2), and user (mode 3). 


When the processor is in kernel mode, the executing software has 
complete control of, and responsibility for, the system. When the 
processor iS in any other mode, the processor is inhibited from 
executing privileged instructions. The processor status longword 
contains the current access mode field. The operating system uses 
access modes to define protection levels for software executing in 
the context of a process. For example, the executive runs in 
kernel and executive modes and is most protected. The command 
interpreter is less protected and runs in Supervisor mode. The 
debugger runs in user mode and isS no more protected than normal 
user programs. 


access type -- The way in which the processor accesses instruction 
operands. Access types are: read, write, modify, address, and 
branch. 


alignment -- The address boundary at which a program section is 
based. 
allocate a device -- To reserve a particular device unit for 


exclusive use. A user process can allocate a device only when that 
device is not allocated by any other process. 


allocation -- The number of bytes of memory contributed by a 
program section to a particular module. 


alphanumeric character -- An upper or lower case letter (A--Z, 
a--z), a dollar sign (S$), an underscore (_), or a decimal digit 
(9--9) ° 


ancillary control process (ACP) -- A process that actS aS an 
interface between user software and an I/O driver. An ACP provides 
functions supplemental to those performed in the driver, such as 
file and directory management. 


argument -- An independent value within a command statement that 


specifies where, or on what, the command will operate (e.g., 
address, data). 
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argument pointer -- General register 12 (R12). By convention, AP 
contains the address of the base of the argument list for 
procedures initiated using the CALL instructions. 


assign a channel -- To establish the necessary software linkage 
between a user process and a device unit before a uSer process can 
transfer any data to or from that device. A uSer process requests 
the system to assign a channel and the system returns a channel 
number. 


assembler -- A program that translates source language code, whose 
operations correspond directly to machine op codes, into object 
language code. 


asynchronous system trap (AST) -- A software-Simulated interrupt 
to a user-defined service routine. ASTs enable a user process to 
be notified asynchronously, with respect to its execution, of the 
occurrence of a specific event. If a user process has defined an 
AST routine for an event, the system interrupts the process and 
executes the AST routine when that event occurs. When the AST 
routine exits, the system resumes the process at the point where 
it was interrupted. 


attributes -- Various characteristics that can be assigned by the 
programmer to each psect in a module (e.g., ABS). 


base register -- A general register used to contain the address of 
the entry ina list, table, array, or other data structure. 


block -- 1. The smallest addressable unit of data that the 
specified device can transfer in an I/0 operation (512 contiguous 
bytes for most disk devices). 2. An arbitrary number of contiguous 
bytes used to store logically related status, control, or other 
processing information (1i.e., process control block). 


breakpoint -- In diagnostics, an address assigned through the 
diagnostic Supervisor. When the PC equals the value of the 
breakpoint, control returns to the diagnostic Supervisor. 


boot (bootstrap) -- A program that loads another (usually larger) 
program into memory from a peripheral device. 

buffer -- A temporary data Storage area. 

call frame -- A standard data structure built on the stack during 


a procedure call, starting from the location addressed by the FP 
to lower addresses, and popped off during a return from procedure 
(also called stack frame). 


channel -- A logical path connecting a uSer process to a physical 
device unit. A user process requests the operating system to 
assign a channel to a device so that the process can transfer data 
to or from that device. 
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command file -- A file containing command strings. 


command interpreter -- Procedure-based code to receive, syntax 
check, and parse commands typed by the user at a terminal or 
submitted in a command file. 


command parameter -- The positional operand of a command delimited 
by spaces, such as a file specification, option, or constant. 


command string -- A line, or a set of continued lines, normally 
terminated by typing the carriage return key containing a command, 
and optionally, information modifying the command. A _ complete 
command string consists of a command; its qualifiers, if any; its 
parameter (file specifications, for example), if any; and their 
qualifiers, if any. 


concatenate (CON) -- A program section attribute. If a psect is 
concatenated, all psects of the same name yet from different 
modules are to be assigned contiguous addresses in the virtual 
address space. Each module can specify an independent alignment. 
The linker performs the necessary padding of zero bytes between 
contributions. The base alignment of the resulting concatenated 
psects is according to the greatest alignment granularity of all 
the contributions to the psect. For example, if the greatest 
alignment granularity of all contributors is a page, the psect is 
page-aligned; although, some contributors may be byte-aligned, 
others word-aligned, etc. 


condition -- An exception condition detected and declared by 
software. 


condition codes -- Four bits in the processor status word that 
indicate the results of the previously executed instruction. 


condition handler -- A procedure that a process wants the system 
to execute when an exception condition occurs. When an exception 
condition does occur, the operating system searches for a 
condition handler. When it finds the condition handler, the 
operating system initiates the handler immediately. The condition 
handler may perform some act to change the situation that caused 
the exception condition and then continue execution of the process 
that incurred the exception condition. Condition handlers execute 
in the context of the process at the access mode of the code that 
incurred the exception condition. 


context switching -- Interrupting the activity in progress and 
Switching to another activity. Context Switching occurs as one 
process after another is scheduled for execution. The operating 
System saves the interrupted process's hardware context in its 
hardware PCB uSing the save process context instruction, loads 
another process's hardware PCB into the hardware context uSing the 
l6ad process context instruction, and schedules that process for 
execution. 
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cylinder -- The tracks at the Same radius on all recording 
surfaces of a disk pack. 


default -- Assumed value supplied when a command qualifier does 
not specifically override the normal command function; also, 
Fields in a file specification that the system fills in when the 
specification is not complete. 


default disk -- The system disk to which the system writes all 
files that the operator creates, by default. The default is used 
whenever a file specification in a command does not explicitly 
name a device. 


delimiter -- A character or symbol used to Separate or limit items 
within a command or data string. However, the delimiter is not a 
member of the string. 


device -- The general name for any physical terminus or link 
connected to the processor that is capable of receiving, Storing, 
Or transmitting data. Card readers, line printers, and terminals 
are examples of record-oriented devices. Magnetic tape devices and 
disk devices are examples of mass Storage devices. Terminal line 
interfaces and interprocessor links are examples of communications 
devices. 


device interrupt -- An interrupt received on interrupt priority 
levels 16 through 23. Device interruptS can be requested only by 
devices, controllers, and memories. 


device name -- The field in a file specification that identifies 
the device unit on which a file is stored. Device names also 
include the mnemonics that identify an I/O peripheral device in a 
data transfer request. A device name consists of a mnemonic 
followed by a controller identification letter (if applicable), 
followed by a unit number (if applicable). A colon (:) Separates 
it from following fields. 


direct I/O -- A mode of access to peripheral devices in which the 
program addresses the device registers directly, without relying 
on Support from the operating system drivers. 


drive -- The electro-mechanical unit of a mass storage device 
system on which a recording medium (disk cartridge, disk pack, or 
magnetic tape reel) is mounted. 


driver -- The set of system code that handles physical I/0 to a 
device. 
entry mask -- A word (1) whose bits represent the registers to be 


saved or restored on a Subroutine or procedure call using the call 
and return instructions, and (2) which includes trap enable bits. 


entry point -- A location that can be specified as the object of a 
call. It contains an entry mask and exception enables known as the 
entry point mask. 
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event -- A change in process status or an indication of the 
occurrence of some activity that concerns an individual process or 
cooperating processes. An incident reported to the scheduler that 
affects a process's ability to execute. Events can be synchronous 
with the process's execution (a wait request, or they can be 
asynchronous (I/O completion). Some examples of events: swapping, 
wake request, page fault. 


event flag -- A bit in an event flag cluster that can be set or 
cleared to indicate the occurrence of the event associated with 
that flag. Event flags are used to synchronize activities in a 
process or among many processes. 


exception -- An event detected by the hardware (other than an 
interrupt or jump, branch, case, or call instruction) that changes 
the normal flow of instruction execution. An exception is always 
caused by the execution of an instruction or set of instructions, 
while an interrupt is caused by an activity in the system 
independent of the current instruction. There are three types of 
hardware exceptions: traps, faults, and aborts. Examples are: 
attempts to execute a privileged or reserved instruction; trace 
traps; compatibility mode faults; breakpoint instruction 
execution; and arithmetic traps such as overflow, underflow, and 
divide-by-zero. 


exception condition -- A hardware- or software-detected event 
(other than an interrupt or jump, branch, case, or call 
instruction) that changes the normal flow of instruction 
execution. 


exception dispatcher -- An operating system procedure that 
searches for a condition handler when an exception condition 
occurs. If no exception handler is found for an exception or 
condition, the image that incurred the exception is terminated. 


executable (EXE) -- A program section attribute. The psect 
contains only instructions. This attribute provides the capability 
to separate instructions from read-only and read/write data. The 
linker uses this attribute in gathering psects and in the 
verification of the transfer address that must be present in an 
executable psect. 


executable image -- An image that is capable of being run in a 
process. When run, an executable image is read from a file for 
execution in a process. 


executive -- The generic name for the collection of procedures 
included in the operating system software that provides the basic 
control and monitor functions of the operating system. 


file -- A logically related collection of data treated as a 
physical entity that occupies one or more blocks on a volume such 
as disk or magnetic tape. A file can be referenced by a name 
assigned by the user. A file normally consists of one or more 
logical records. 
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file specification -- A unique name for a file on a mass storage 
medium. 


frame pointer -- General register 13 (R13). By convention, FP 
contains the base address of the most recent call frame on the 
stack. 


global symbol -- A symbol defined in a module that is potentially 
available for reference by another module. The linker resolves 
(matches references with definitions) global symbols. Contrast 
with local symbol. 


granularity -- The alignment of a contribution to a psect on a 
boundary. The alignment granularity may be byte, word, quadword, 
Or page. 


home block -- A block in the index file that contains the volume 
identification, such as volume label and protection. 


image -- An image consists of procedures and data that have been 
bound together by the linker. There are three types of images: 
executable, sharable, and system. 


index file -- The file on a FILES-11l1 volume that contains the 
access information for all files on the volume and enables the 
operating system to identify and access the volume. 


interrupt -- An event (other than an exception or branch, jump, 
case, or call instruction) that changes the normal flow of 
instruction execution. Interrupts are generally external to the 
process executing when the interrupt occurs. 


interrupt stack -- The system-wide stack used when executing in an 
interrupt service context. At any time, the processor is either in 
a process context executing in user, Supervisor, executive, or 
kernel mode; or in system-wide interrupt service context operating 
with kernel privileges, as indicated by the interrupt stack and 
current mode bits in the PSL. The interrupt stack 1S not 
context-Switched. 


I/O function code -- A 6-bit value specified in a queue I/0 
request system service that describes the particular I/O operation 
to be performed (e.g., read, write, rewind). 


library file -- A direct access file containing one or more 
modules of the same module type. 


linked commands -- A group of independent commands’ connected 
together (linked) so as to form a Single executable list of 
commands. Once initiated, the entire linked command list may be 
executed without further operator intervention. 
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linker -- A program that reads one or more object modules created 
by language processors and produces an executable image file, a 
sharable image file, or a system image file. 


linking -- The resolution of external references between object 
modules used to create an image; the acquisition of referenced 
library routines, service entry points, and data for the image; 
and the assignment of virtual addresses to components of an image. 


link map -- A link map shows the virtual memory allocation of the 
total program image. The link map is found in a program listing in 
the program section allocation synopsis. 


literal -- An operand which is used immediately, without being 
translated to some other value. An operand which specifies itself. 


literal argument -- An independent value within a command 
Statement that specifies itself. 


local symbol -- A symbol that is meaningful only to the module 
that defines it. Symbols not identified to a language processor as 
global symbols are considered to be local symbols. A _ language 
processor resolves (matches references with definitions) local 
symbols. They are known to the linker and cannot be made available 
to another object module. They can, however, be passed through the 
linker to the symbolic debugger. Contrast with global symbol. 


logical block -- A block on a mass storage device identified by 
using the volume-relative address rather than the physical 
(device-oriented) address or the virtual (file-relative) address. 
The blocks that comprise the volume are labeled sequentially 
Starting with logical block @. 


macro -- A _ statement that requests a language processor. to 
generate a predefined set of instructions. 


memory management -- The system functions that include the 
hardware's page mapping and protection and the operating system's 
image activator and pager. 


module -- A part of a program assembled aS a unit. Modular 
programming allows the development of large programs in which 
separate parts share data and routines. 


mount a volume -- To logically associate a volume with the 
physical unit on which it is loaded (an activity accomplished by 
system software at the request of an operator). Or, to load or 
place a magnetic tape or disk pack on a drive and place the drive 
on-line (an activity accomplished by a system operator). 


object module -- The binary output of a language processor such as 
the assembler or a compiler, which is used as input to the linker. 


operand -- a value (address or data) that is operated on, or with, 
by an instruction. 
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overlay (OVR) -- A program section attribute. If a psect is 
overlayed, all contributions to the psect have the same base 
address. The length of the psect is the Size of the largest 
contribution. All contributions to an overlayed psect must have 
the same alignment. 


page -- A set of 512 contiguous byte locations used as the unit of 
memory mapping and protection. Also, the data between the 
beginning of a file and a page marker, between two markers, or 
between a marker and the end of a file. 


page frame number (PFN) -- The address of the first byte of a page 
in physical memory. The high-order 21 bits of the physical address 
of the base of a page make up the PFN. 


page table entry (PTE) -- The data structure that identifies the 
location and status of a page of virtual address space. When a 
virtual page is in memory, the PTE contains the page frame number 
needed to map the virtual page to a physical page. When it is not 
in memory, the PTE contains the information needed to locate the 
page on secondary storage (disk). 


parameter -- A parameter is the object of a command. It can be a 
file specification, a keyword option, or a symbol value passed to 
a command procedure. In diagnostics, parameters are usually 
operator-sSsupplied answers to questions asked by a program 
concerning devices to be tested. 


parameter switch -- A command qualifier. In diagnostics, it is 
preceded by a slash (/). 


parser -- A procedure that breaks down the components of a command 
into structural forms. 


physical address -- The address used by hardware to identify a 
location in physical memory or on directly addressable secondary 
Storage devices such as disks. A physical memory address consists 
of a page frame number and the number of a byte within the page. A 
physical disk block address consists of a cylinder or track and 
sector number. 


physical block -- A block on a mass storage device referred to by 
its physical (device-oriented) address rather than a _ logical 
(volume-relative) or virtual (file-relative) address. 


position independent code (PIC) -- A program section attribute. 
The contents of the psect do not depend on a specific location in 
virtual memory. The converse is nonposition independent code 
(NOPIC). 
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priority -- The rank assigned to an activity that determines its 
level of service. For example, when several jobs contend for 


System resources, the job with the highest priority receives 
service first. 


Program section -- A portion of a module. The assembler creates a 
number of program sections (psect) within a module, according to 
directives by the program developer. In addition, any code that 
precedes the first defined program section is placed in the BLANK 
program section by the assembler. 


Through program sectioning the program developer controls’ the 
virtual memory allocation of a program. Any program attributes 
established by the program section directive are passed on to the 
linker. Thus, program sections can be declared as read only, 
nonexecutable, etc. See the VAX-11 MACRO Language Reference Manual 
for an explanation of the various program section attribute 


functions. 


In the diagnostic programs, each test is given a separate program 
section. 


prompt -- A program's typed out response to and/or request for 
operator action. 


qualifier -- A portion of a command string that modifies a command 
verb or command parameter by selecting one of several options. A 
qualifier, if present, follows the command verb or parameter to 
which it applies and is in the format: /qualifier:option. For 
example, in the command string "PRINT <filename> /COPIES:3", the 
COPIES qualifier indicates that the uSer wants three copies of a 
given file printed. 


queue -- A list of commands or jobs waiting to be processed. 


queue I/O -- A mode of access to peripheral devices in which a 
program calls on driver routines provided by the VMS operating 
system or the diagnostic supervisor to transfer data. 


radix -- The base of the number system currently in uSe. 


readable (RD) -- A program section attribute. The contents of the 
psect can be read at the execute time. The converse is nonreadable 
(NORD) . 


record -- A collection of adjacent items of data treated as a 
unit. A logical record can be of any length whose significance is 
determined by the programmer. A physical record is a 
device-dependent collection of contiguous bytes such as a block on 
a disk, or a collection of bytes sent to or received from a 
record-oriented device. 


relocatable (REL) -- A program section attribute. The psect must 
be assigned a base address by the linker. This psect can contain 
code and/or data. 
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script file -- A line-oriented ASCII file that contains a list of 
commands. 


section -- A group of tests in a diagnostic program that may be 
selected by the operator. 


sector -- A portion of a track on the surface of a disk. On a 
VAX-l11 system, each track on a disk is normally divided into 22 
sectors. 


semantics -- The interpretation of and relation between commands 
or command symbols. 


Sharable image -- An image that has all of its internal references 
resolved, but which must be linked with an object module(s) to 
produce an executable image. A sharable image cannot be executed. 
A sharable image file can be used to contain a library of 
routines. A sharable image can be installed as a global section by 
the system manager. 


Stack -- An area of memory set aSide for temporary storage, or for 
procedure and interrupt service linkages. A stack uses the 
last-in, first-out concept. AS items are added to (pushed on) the 
stack, the stack pointer decrements. As items are retrieved from 
(popped off) the stack, the stack pointer increments. 


stack frame -- A standard data structure built on the stack during 
a procedure call, starting from the location addressed by the FP 
to lower addresses, and popped off during a return from procedure. 
Also called call frame. 


Stack pointer -- General register 14 (R14). SP contains’ the 
address of the top (lowest address) of the processor-defined 
Stack. Reference to SP will access one of the five possible stack 
pointers: kernel, executive, Supervisor, user, or interrupt, 
depending on the value in the current mode and interrupt stack 
bits in the Processor Status Longword (PSL). 


Standalone mode -- A diagnostic program environment in which the 
program and the diagnostic supervisor run without the VMS 
operating system. The operator must use the console terminal when 
running diagnostics in the standalone mode, and no other users 
have access to the system. 


Symbolic argument -- An argument within a command that refers to 
another value. 


Syntax -- The rules governing a command language structure. The 
way in which command symbols are ordered to form meaningful 
statements. 


Syntactic unit -- An item contained within a command statement 
(e.g., an argument, a qualifier). 
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System image -- The image that is read into memory from secondary 
Storage when the system is started up. 


test -- A unit of a diagnostic program that checks a specific 
function or portion of the hardware. 


time stamp -- A statement of the time of day at which a specific 
event occurred. 


track -- A collection of blocks at a single radius on one 
recording surface of a disk. 


trap -- An exception condition that occurs at the end of the 
instruction that caused the exception. The PC saved on the stack 
is the address of the next instruction that would normally have 
been executed. All software can enable and disable some of the 
trap conditions with a single instruction. 


unit record device -- A device such aS a card reader or line 
printer. 
unwind the call stack -- To remove call frames from the stack by 


tracing back through nested procedure calls using the current 
content of the FP register and FP register content stored on the 
stack for each call frame. 


UUT (unit under test) -- The device or portion of the computer 
hardware being tested by a diagnostic program. 


virtual block number -- A number used to identify a block on a 
mass storage device. The number is a file-relative address rather 
than a logical (volume-oriented) or physical (device-oriented) 
address. The first block in a file is always virtual block number 
one. 


writable (WRT) -- A program section attribute. The content of the 
psect can be modified at execute time. The converse is nonwritable 
(NOWRT) . 
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